Create Contract

Create a Contract NFT draft with the RWA SDK. Set counterparties, content hash, and URL, pay the ERC20 setup fee, and inspect the receipt.

cnft.createContract(CreateContract)

Create a Contract NFT draft by initializing the contract with counterparties and content, and paying the setup fee (ERC20). This sends a transaction from the contract controller.

The contract controller must have an ONCHAINID identity with a valid KYC claim and hold at least the setup fee (1 PEAQ), or the call reverts with NoIdentityFound, UserNotKyxd, or Insufficient balance. Counterparties also need a valid KYC claim before they can sign.

CreateContract Type Parameters

Parameter	Type	Required	Description
contractController	Signer	Required	Signer that controls the contract and submits the transaction. Must be connected to a provider.
erc20	string	Required	Setup fee token address. Must be the native PEAQ precompile, rwa_sdk.getAddresses().erc20.peaq (0x0000000000000000000000000000000000000809); the contracts charge fees in PEAQ only.
tokenDecimals	number	Required	ERC20 token decimals for human-readable fee amounts.
counterparties	string[]	Required	Array of counterparty EOA addresses that must sign the contract.
contractNft	string	Required	Contract NFT contract address.
contractHash	string	Required	Content hash (e.g., keccak256 of the contract content).
url	string	Required	URL pointing to the contract content/metadata.

Returns

Field	Type	Description
status	created	Status of the operation.
contractNft	string	Contract NFT contract address.
contractId	string	Contract ID for the draft.
contractController	string	Controller EOA address.
counterparties	string[]	Counterparty addresses included in the draft.
content	{ hash: string; url: string }	Content hash and URL.
fee	{ token: string; tokenDecimals: number; setupAmount: bigint; balanceBefore: bigint; balanceAfter: bigint; humanTokenDelta: string }	Setup fee and PEAQ balance details. Because the fee token is native PEAQ, humanTokenDelta includes the gas for the approval and creation transactions.
receipt	TransactionReceipt	Transaction receipt for the creation call.

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 (submits tx and pays ERC20 fee)
  const alice = new Wallet(process.env.ALICE_PRIVATE_KEY!, provider);

  // 2. Counterparties
  const bob = process.env.BOB_PUBLIC_ADDRESS!;
  const charlie = process.env.CHARLIE_PUBLIC_ADDRESS!;

  // 3. Prepare content
  const contractNft = "0x35D67095A5a6f00CBE288cF744b3efC48de3699a";
  const url = "https://example.com";
  const content = `This is a test contract ${Date.now()}`;
  const contractHash = keccak256(toUtf8Bytes(content));

  // 4. Create contract draft
  const result = await rwa_sdk.cnft.createContract({
    contractController: alice,
    erc20: rwa_sdk.getAddresses().erc20.peaq,
    tokenDecimals: 18,
    counterparties: [bob, charlie],
    contractNft: contractNft,
    contractHash: contractHash,
    url: url
  });
  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 controller (submits tx and pays ERC20 fee)
  const alice = new Wallet(process.env.ALICE_PRIVATE_KEY, provider);

  // 2. Counterparties
  const bob = process.env.BOB_PUBLIC_ADDRESS;
  const charlie = process.env.CHARLIE_PUBLIC_ADDRESS;

  // 3. Prepare content
  const contractNft = "0x35D67095A5a6f00CBE288cF744b3efC48de3699a";
  const url = "https://example.com";
  const content = `This is a test contract ${Date.now()}`;
  const contractHash = keccak256(toUtf8Bytes(content));

  // 4. Create contract draft
  const result = await rwa_sdk.cnft.createContract({
    contractController: alice,
    erc20: rwa_sdk.getAddresses().erc20.peaq,
    tokenDecimals: 18,
    counterparties: [bob, charlie],
    contractNft: contractNft,
    contractHash: contractHash,
    url: url
  });
  console.log("Result", result);
}

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

Example outputs

Result {
  status: 'created',
  contractNft: '0x35D67095A5a6f00CBE288cF744b3efC48de3699a',
  contractId: '110399289532161649501907442204937966168773206671183427730650359857010370852178',
  contractController: '0x16cd4D21537eD8F33bE08271A9FA6DCC426709b2',
  counterparties: [
    '0xbA9274C766A5961C40bB4a3e0e107699EE9Dab9C',
    '0x68af027F5AaE3b1B6ff770b87aB7ac360b54ad40'
  ],
  content: {
    hash: '0x...',
    url: 'https://example.com'
  },
  fee: {
    token: '0x...',
    tokenDecimals: 18,
    setupAmount: 1000000000000000000n,
    balanceBefore: 5000000000000000000n,
    balanceAfter: 3998000000000000000n,
    humanTokenDelta: '1.002'
  },
  receipt: TransactionReceipt {
    ...
  }
}

The contract ID is deterministic: it is the keccak256 hash of the initiator, counterparties, content hash, and URL.