Prepare an unsigned on-chain transaction for a trace event

POST

/api/v1/events/prepare

• Production
• Sandbox (us-east-1)

Validates the event, writes canonical metadata to IPFS, returns an unsigned transaction + the IPFS CID + an eventId. The client signs locally and submits to the chain RPC directly. Optionally track the resulting txHash via POST /api/v1/tx/track.

Authorizations

• bearerAuth
• apiKey

Request Body ^required

object

processType

required

Process map key (e.g. RICE_HARVESTING). Defined by your tenant’s process map.

string

Example

RICE_HARVESTING

inputTokenIds

Token IDs of input lots (for transformation events).

Array<integer>

outputTlc

TLC of the output lot to mint.

string

Example

TLC-2026-001

outputCustodian

EIP-55 wallet address of the output custodian.

string

metadata

required

Free-form canonical metadata. Validated against the process map’s schema.

object

key

additional properties

any

Responses

200

Prepared transaction + metadata

object

eventId

string

ipfsCid

string

preparedTx

object

to

Contract address

string

data

Hex-encoded calldata

string

gasEstimate

integer

chainId

integer