Skip to content

Before you can send assets from a new Tezos account, you need to reveal the account public key on chain to allow validators to check transactions.

Since the reveal operation incurs some fees, you can receive funds first before performing the operation.

Learn more about receiving assets

Prerequisites

To reveal your Tezos account, you need the following:

PrerequisiteAdditional information
The account ID of the account to revealView account details
Enough funds in the account to cover the transaction fees and the amountCheck account balances
The following new IDs, in a standard UUID format:
  • A transaction order ID
  • An intent ID

Reveal the public key

System change process

All new requests to change the system state follow the same process. To familiarize yourself with this process first, see Manage intents and approvals.

To reveal a Tezos account public key:

  1. Prepare the request body in the standard intent proposal format, with a payload block similar to the example shown in Payload example. For more information, see User-signed proposal request body.

  2. Call the Perform a dry run for an intent operation, with the request field excluded. For more information, see Dry run intents.

    This step is optional, but highly recommended. A dry run can reveal errors or unintended consequences of the intent, as well as estimate the fees incurred by the transaction.

    You can repeat this step more than once to obtain the required result.

  3. Sign the request body and call the Propose an intent operation. For more information, see Propose an intent to create an entity.

  4. Check the update. For more information, see Check updates.

When the transaction order is successfully approved, Ripple Custody does the following:

  • Creates a transaction, to reveal the account public key on the blockchain.
  • Creates one or more transfers, to represent the separate amounts associated with the transaction, such as the cryptocurrency amount and the fees.

Payload example

{
    "payload": {
        "id": "953d75b2-e384-46e9-8a72-a1ce753a50e2",
        "accountId": "953d75b2-e384-46e9-8a72-a1ce753a50e2",
        "parameters": {
            "operation": {
                "type": "Reveal"
            },
            "feeStrategy": {
                "priority": "Low",
                "type": "Priority"
            },
            "maximumFee": "4000",
            "type": "Tezos"
        },
        "description": "",
        "customProperties": {},
        "type": "v0_CreateTransactionOrder"
    }
}

Fields of the payload block to note are as follows:

FieldDescription
accountIdInternal account ID of the Tezos account to reveal.
operation.typeReveal
parameters.feeStrategyThe fee strategy to use for the transaction. For Tezos, the Priority strategy applies. For more information, see Fee strategy and maximum fee.
parameters.maximumFeeThe maximum fee, in micro tez. For more information, see Fee strategy and maximum fee.
parameters.typeLedger type, in this case Tezos.
typev0_CreateTransactionOrder