Signing

Unified signing intent (EIP-191, EIP-712, EIP-2718 types 0-4)

post/v1/agents/{agent_id}/sign

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/sign
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Request body

intent_type'personal_sign' | 'typed_data' | 'eip712_digest' | 'transaction' required
chainstring required
signing_key_pathstring

Vault path to signing key. Auto-resolves per-chain signing key if provisioned, otherwise keys/{chain}-signer.

messagestring

Hex-encoded message bytes (for personal_sign)

typed_dataobject

EIP-712 typed data JSON (for typed_data)

hashstring

Client-computed 32-byte digest (0x-prefixed) for the eip712_digest intent. Signed directly (blind signing); requires the agent's raw_signing_enabled flag. Use for ERC-1271/ERC-7739 nested EIP-712 flows (e.g. Polymarket) where the canonical hash is computed client-side.

tx_typeinteger

EIP-2718 type: 0=legacy, 1=2930, 2=1559, 3=4844, 4=7702

tostring
valuestring
datastring
nonceinteger
gas_limitinteger
gas_pricestring
max_fee_per_gasstring
max_priority_fee_per_gasstring
access_listobject[]
max_fee_per_blob_gasstring
blob_versioned_hashesstring[]
authorization_listobject[]
sign_onlyboolean

When true, sign only (do not broadcast). Non-EVM transaction intents only.

destination_taginteger

Non-EVM (XRP): destination tag for exchange deposits

memostring

Non-EVM (XRP, Solana): optional memo

fee_rate_sat_per_vbyteinteger

Non-EVM (Bitcoin): override the fetched fee rate (sat/vByte)

fee_limit_suninteger

Non-EVM (Tron): TRC-20 energy fee limit in sun

token_mintstring

Non-EVM (Solana SPL / Tron TRC-20): token mint or contract address; omit for native transfer

token_decimalsinteger

Non-EVM (Solana, Tron): token decimals (default 6)

ttlinteger

Non-EVM (Cardano): transaction time-to-live (absolute slot)

xrpl_tx_jsonobject

Raw XRPL transaction JSON for full transaction type coverage. When present (and chain is XRP), the handler uses the xrpl-rust binary codec to encode and sign the transaction as-is. Supports all XRPL transaction types: Payment, TrustSet, OfferCreate, OfferCancel, AccountSet, EscrowCreate, NFTokenMint, AMMCreate, and 20+ more. Account, Sequence, Fee, LastLedgerSequence, and SigningPubKey are auto-filled when absent.

approval_idstring uuid

Optional pending approval ID. When consensus policies match, clients resubmit with this field set to bypass the 202 gate after the approval has been executed.

raw_transactionstring

Pre-built raw transaction as a base64-encoded byte string. When provided, the handler decodes and deep-inspects the transaction for policy evaluation before signing. Supported for non-EVM chains where the client constructs the transaction payload.

tron_transactionobject

Pre-built Tron transaction JSON object. When provided, the handler signs the transaction as-is using the Tron protobuf format. Enables full Tron transaction type coverage beyond simple TRX/TRC-20 transfers.

Response

Signed result

intent_typestring
chainstring
fromstring
signaturestring nullable
signed_txstring nullable
tx_hashstring nullable
message_hashstring nullable
typed_data_hashstring nullable
tx_typeinteger nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.