Sign Contract

Sign a Contract NFT as a counterparty with the RWA SDK. Covers signer parameters, signature progress, completion status, and transaction receipts.

cnft.signContract(SignContract)

Sign a Contract NFT as a counterparty. This sends a transaction from the counterparty signer. If the final signature is collected, the contract becomes completed.

The counterparty must have an ONCHAINID identity with a valid KYC claim and be listed in the draft’s counterparties, or the call reverts with UserNotKyxd or Signer is not a counterparty.

SignContract Type Parameters

Parameter	Type	Required	Description
counterpartySigner	Signer	Required	Counterparty signer authorized to sign the contract. Must be connected to a provider.
contractNft	string	Required	Contract NFT contract address.
contractId	string	Required	Contract ID to sign.

Returns

Field	Type	Description
status	completed or signed or mined_unknown	Status of the signing operation.
contractId	string	Contract ID that was signed (from emitted event when available).
counterpartySigner	string	Counterparty address that signed (from emitted event when available).
receipt	TransactionReceipt	Transaction receipt for the signing call.
progress	{ collected: number; total: number }	Optional signature progress when status is signed. Total includes the initiator (+1).

Usage

TypeScript

import 'dotenv/config';
import { RWA, Chain, type SDKInit } from '@peaq-network/rwa';
import { JsonRpcProvider, Wallet, keccak256, toUtf8Bytes } from 'ethers';

async function main() {
  // 0. Create RWA instance and get provider
  const provider = new JsonRpcProvider(process.env.HTTPS_BASE_URL);
  const init: SDKInit = { chainId: Chain.AGUNG, provider: provider };
  const rwa_sdk = new RWA(init);

  // 1. Contract controller and counterparties
  const alice = new Wallet(process.env.ALICE_PRIVATE_KEY!, provider);
  const bob = new Wallet(process.env.BOB_PRIVATE_KEY!, provider);
  const charlie = new Wallet(process.env.CHARLIE_PRIVATE_KEY!, provider);

  // 2. Get information from contract creation
  const contractNft = "0x35D67095A5a6f00CBE288cF744b3efC48de3699a";
  const contractId = "<contractId from createContract>";

  // 3. Counterparty signs
  const result = await rwa_sdk.cnft.signContract({
    counterpartySigner: bob,
    contractNft: contractNft,
    contractId: contractId
  });
  console.log("Result", result);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

JavaScript

import 'dotenv/config';
import { RWA, Chain } from '@peaq-network/rwa';
import { JsonRpcProvider, Wallet, keccak256, toUtf8Bytes } from 'ethers';

async function main() {
  // 0. Create RWA instance and get provider
  const provider = new JsonRpcProvider(process.env.HTTPS_BASE_URL);
  const rwa_sdk = new RWA({ chainId: Chain.AGUNG, provider });

  // 1. Contract counterparty
  const bob = new Wallet(process.env.BOB_PRIVATE_KEY, provider);

  // 2. Get information from contract creation
  const contractNft = "0x35D67095A5a6f00CBE288cF744b3efC48de3699a";
  const contractId = "<contractId from createContract>";

  // 3. Counterparty signs
  const result = await rwa_sdk.cnft.signContract({
    counterpartySigner: bob,
    contractNft: contractNft,
    contractId: contractId
  });
  console.log("Result", result);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

Example outputs

Signed (more signatures required):

Result {
  status: 'signed',
  contractId: '110399289532161649501907442204937966168773206671183427730650359857010370852178',
  counterpartySigner: '0xbA9274C766A5961C40bB4a3e0e107699EE9Dab9C',
  receipt: TransactionReceipt {
    ...
  },
  progress: { collected: 2, total: 3 }
}

Completed (final signature collected):

Result {
  status: 'completed',
  contractId: '110399289532161649501907442204937966168773206671183427730650359857010370852178',
  counterpartySigner: '0x68af027F5AaE3b1B6ff770b87aB7ac360b54ad40',
  receipt: TransactionReceipt {
    ...
  }
}

If no ContractSigned or ContractCompleted event is found in the receipt, the SDK returns status: 'mined_unknown' with the contractId you passed in and counterpartySigner set to 'unknown'.