TransferCip56

Transfer a CIP-56 token to a receiver

Transfer an amount of a CIP-56 instrument to a receiver. The instrument must be fully qualified (both instrument_id and instrument_admin party) — this matches the Daml InstrumentId = { id: Text, admin: Party } definition.

Invoked through the two-phase transaction flow with:

• operation = TRANSACTION_OPERATION_TRANSFER_CIP56
• params.transfer_cip56 = TransferCip56Params { … }

Params

instrument_id · string · required

Token identifier.

instrument_admin · string · required

Admin party of the instrument.

receiver_party · string · required

Canton party ID of the receiver.

amount · string · required

Decimal amount to transfer.

reference · string (optional)

Client-supplied reference attached to the transfer.

message TransferCip56Params {
  string instrument_id    = 1;
  string instrument_admin = 2;
  string receiver_party   = 3;
  string amount           = 4;
  optional string reference = 5;
}

See also

• AcceptCip56 — how the counterparty claims the resulting TransferOffer.
• GetBalances — inspect current CIP-56 holdings for the authenticated party.
• GetActiveContracts — enumerate CIP-56 contracts in the ACS.