Create RPC transaction

Create an intent to execute an RPC method on a wallet. The intent must be authorized by either the wallet owner or signers before it can be executed.

POST /v1/intents/wallets/{wallet_id}/rpc

Create RPC intent

cURL

curl --request POST \
  --url https://api.privy.io/v1/intents/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '
{
  "method": "eth_signTransaction",
  "params": {
    "transaction": {
      "from": "<string>",
      "to": "<string>",
      "chain_id": "<string>",
      "nonce": "<string>",
      "data": "<string>",
      "value": "<string>",
      "type": 0,
      "gas_limit": "<string>",
      "gas_price": "<string>",
      "max_fee_per_gas": "<string>",
      "max_priority_fee_per_gas": "<string>",
      "authorization_list": [
        {
          "contract": "<string>",
          "chain_id": "<string>",
          "nonce": "<string>",
          "r": "<string>",
          "s": "<string>",
          "y_parity": 123
        }
      ]
    }
  },
  "address": "<string>",
  "chain_type": "ethereum",
  "wallet_id": "<string>"
}
'

200

{
  "intent_id": "clpq1234567890abcdefghij",
  "intent_type": "RPC",
  "created_by_display_name": "[e-mail]",
  "created_by_id": "did:privy:clabcd123",
  "created_at": 1741834854578,
  "resource_id": "xs76o3pi0v5syd62ui1wmijw",
  "authorization_details": [
    {
      "members": [
        {
          "type": "user",
          "user_id": "did:privy:clabcd123",
          "signed_at": null
        }
      ],
      "threshold": 1,
      "display_name": "Admin Key Quorum"
    }
  ],
  "status": "pending",
  "custom_expiry": false,
  "expires_at": 1741921254578,
  "request_details": {
    "method": "POST",
    "url": "https://api.privy.io/v1/wallets/xs76o3pi0v5syd62ui1wmijw/rpc",
    "body": {
      "method": "eth_sendTransaction",
      "caip2": "eip155:8453",
      "chain_type": "ethereum",
      "params": {
        "transaction": {
          "to": "0x0000000000000000000000000000000000000000",
          "value": 1
        }
      }
    }
  }
}

Authorizations

Authorization · string · header · required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

privy-app-id · string · required

ID of your Privy app.

privy-request-expiry · string

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Path Parameters

wallet_id · string · required

ID of the wallet.

Body

application/json

EthereumSignTransactionRpcInput

EthereumSendTransactionRpcInput

EthereumPersonalSignRpcInput

EthereumSignTypedDataRpcInput

EthereumSecp256k1SignRpcInput

EthereumSign7702AuthorizationRpcInput

EthereumSignUserOperationRpcInput

EthereumSendCallsRpcInput

AptosSignTransactionRpcInput

SolanaSignTransactionRpcInput

SolanaSignAndSendTransactionRpcInput

SolanaSignMessageRpcInput

SparkTransferRpcInput

SparkGetBalanceRpcInput

SparkTransferTokensRpcInput

SparkGetStaticDepositAddressRpcInput

SparkGetClaimStaticDepositQuoteRpcInput

SparkClaimStaticDepositRpcInput

SparkCreateLightningInvoiceRpcInput

SparkPayLightningInvoiceRpcInput

SparkSignMessageWithIdentityKeyRpcInput

SparkWithdrawRpcInput

SparkGetWithdrawalFeeQuoteRpcInput

TronSignTransactionRpcInput

TronSendTransactionRpcInput

XrplSignTransactionRpcInput

NearSignTransactionRpcRequestBody

ExportPrivateKeyRpcInput

ExportSeedPhraseRpcInput

Executes the EVM eth_signTransaction RPC to sign a transaction.

method · enum<string> · required

Available options: eth_signTransaction

params · EthereumSignTransactionRpcInputParams · object · required

Parameters for the EVM eth_signTransaction RPC.

Show child attributes

address · string

chain_type · enum<string>

Available options: ethereum

wallet_id · string

Response

200 - application/json

Created RPC intent.

Response for an RPC intent

intent_id · string · required

Unique ID for the intent

created_by_display_name · string · required

Display name of the user who created the intent

created_at · number · required

Unix timestamp when the intent was created

resource_id · string · required

ID of the resource being modified (wallet_id, policy_id, etc)

authorization_details · IntentAuthorization · object[] · required

Detailed authorization information including key quorum members, thresholds, and signature status

Show child attributes

status · enum<string> · required

Current status of an intent.

Available options: pending, processing, executed, failed, expired, rejected, dismissed

custom_expiry · boolean · required

Whether this intent has a custom expiry time set by the client. If false, the intent expires after a default duration.

expires_at · number · required

Unix timestamp when the intent expires

intent_type · enum<string> · required

Available options: RPC

request_details · object · required

The original RPC request that would be sent to the wallet endpoint

Show child attributes

created_by_id · string

ID of the user who created the intent. If undefined, the intent was created using the app secret

rejected_at · number

Unix timestamp when the intent was rejected, present when status is 'rejected'

dismissed_at · number

Unix timestamp when the intent was dismissed, present when status is 'dismissed'

dismissal_reason · string

Human-readable reason for dismissal, present when status is 'dismissed'

current_resource_data · Wallet · object

Current state of the wallet before any changes. If undefined, the resource was deleted and no longer exists

Show child attributes

Example:

{
  "id": "id2tptkqrxd39qo9j423etij",
  "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
  "display_name": "Treasury",
  "external_id": "my-order-123",
  "chain_type": "ethereum",
  "policy_ids": [],
  "additional_signers": [],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "parent_wallet_id": null,
  "entity": {
    "id": "jorpjo4rfxj62nx1itt8y1zt",
    "type": "user"
  },
  "created_at": 1741834854578,
  "exported_at": null,
  "imported_at": null,
  "archived_at": null
}

action_result · BaseActionResult · object

Result of RPC execution (only present if status is 'executed' or 'failed')

Show child attributes