Preparar una transacción on-chain sin firmar para un evento de trazabilidad

POST

/api/v1/events/prepare

• URL base de la API provisionada por tenant

Valida el evento, escribe la metadata canónica en IPFS y devuelve una transacción sin firmar más el CID de IPFS y un eventId. El cliente firma localmente y envía directamente al chain RPC. Opcionalmente puede registrar el txHash resultante vía POST /api/v1/tx/track.

Authorizations

• bearerAuth
• apiKey

Request Body ^required

object

processType

required

Clave del mapa de procesos (por ejemplo, RICE_HARVESTING). Definida por el mapa de procesos de tu tenant.

string

Example

RICE_HARVESTING

inputTokenIds

Token IDs de los lotes de entrada (para eventos de transformación).

Array<integer>

outputTlc

TLC del lote de salida a mintear.

string

Example

TLC-2026-001

outputCustodian

Dirección de wallet EIP-55 del custodio de salida.

string

metadata

required

Metadata canónica de formato libre. Validada contra el schema del mapa de procesos.

object

key

additional properties

any

Responses

200

Transacción preparada y metadata

object

eventId

string

ipfsCid

string

preparedTx

object

to

Dirección del contrato

string

data

Calldata codificada en hexadecimal

string

gasEstimate

integer

chainId

integer