POST
/
{custom-url}
curl -X POST \
--url 'https://custom-url/example-callback' \
--data '{
      "type":"sign_start",
      "trans_id":432,
      "request_id":"0000000003",
      "pending_round":false,
      "from":"0xc70d1eebb7c687ec8d56bead73f104d41e6e0bda",
      "to":"0x5EDc9177997Bf6B4db559A5C184051858B3B3704",
      "amount":0,
      "main_chain_symbol":"HECO",
      "input_data":"0xca718c65",
      "interactive_contract":"0xe012F3957226894B1a2a44b3ef5070417a069dC2",
      "txid":"",
}'

Co-Signer calls back to the client system to confirm whether the web3 transaction is normal before signing.

Content-Type application/json;charset=UTF-8

​
Callback Request Parameters

ParamTypeRequiredDescription
typeStringYesCallback type: sign_start for signature initiation, sign_success for successful signature
trans_idIntegerYesTransaction ID
request_idStringYesUnique identifier for the transaction
pending_roundBooleanYesAcceleration status: true for accelerated transactions, false for regular transactions
fromStringYesSender address of the transaction
toStringYesRecipient address of the transaction
amountDecimalYesTransaction amount. Use -1 for infinity
main_chain_symbolStringYesNetwork symbol (unique identifier), e.g., “ETH”
input_dataStringYesInput data for the transaction
interactive_contractStringYesInteractive contract
txidStringNoTransaction hash. Returned when the signature is successful
curl -X POST \
--url 'https://custom-url/example-callback' \
--data '{
      "type":"sign_start",
      "trans_id":432,
      "request_id":"0000000003",
      "pending_round":false,
      "from":"0xc70d1eebb7c687ec8d56bead73f104d41e6e0bda",
      "to":"0x5EDc9177997Bf6B4db559A5C184051858B3B3704",
      "amount":0,
      "main_chain_symbol":"HECO",
      "input_data":"0xca718c65",
      "interactive_contract":"0xe012F3957226894B1a2a44b3ef5070417a069dC2",
      "txid":"",
}'

​
Callback Response Parameters

Return string：

  • SUCCESS means SUCCESS: Co-Signer signs the transaction.
  • FAILURE means FAILURE: Co-Signer will ignore the transaction and not sign.