WDK logoWDK documentation
StartWalletsDeFi & FiatAI & CLITools

Issue and receive RGB assets

Issue NIA assets and create blind or witness receive invoices with the on-chain RGB wallet.

The v2.0.3 account declares Non-Inflatable Asset issuance and blind or witness receive invoices.

Community module, maintained independently by third-party contributors. See Legal and Disclaimers.

Prepare the wallet

Register, synchronize, and confirm that the wallet has suitable Bitcoin UTXOs:

await account.registerWallet()
account.syncWallet()

const unspents = account.listUnspents()
if (unspents.length === 0) {
  throw new Error('Fund or create RGB-compatible UTXOs before continuing')
}

Issue an NIA

const issued = account.issueAssetNia({
  ticker: 'DEMO',
  name: 'Demo Asset',
  amounts: [1_000],
  precision: 0,
})

console.log(issued)

amounts contains issued allocations in asset base units. Validate ticker, name, precision, supply, and destination policy before issuance because issuance is a consequential state change.

The released WDK account declares only issueAssetNia(). Do not infer UDA, CFA, IFA, inflation, or atomic-swap support from another RGB repository or unreleased branch.

Create a blind receive invoice

const receive = account.receiveAsset({
  assetId,
  amount: 100,
  witness: false,
})

console.log(receive.invoice)

A blind receive normally consumes an available allocation-capable UTXO.

Create a witness receive invoice

const receive = account.receiveAsset({
  assetId,
  amount: 100,
  witness: true,
})

Witness receive uses an on-chain witness flow. Select the mode according to the recipient's wallet state, privacy model, and fee requirements.

Handle invoices safely

  • Generate the invoice on the receiving wallet.
  • Transmit the complete invoice over an authenticated channel.
  • Verify the asset ID and amount in your application.
  • Treat the invoice as single-use.
  • Do not log invoices with user-identifying metadata.
  • Refresh transfer state before deciding whether an expired or timed-out receive failed.

The sender needs the invoice string beginning with rgb:. An ordinary Bitcoin address is not an RGB transfer recipient.

Next steps

On this page