Authorize a transaction

Propose an intent to authorize and execute a signature or transaction. This endpoint accepts the same request body as the synchronous RPC endpoint but does not require authorization signatures in the request. Instead, the intent is signed separately and executes once enough signatures are collected.

Intents expire 72 hours after creation by default. Signers must authorize them within this window.

REST API
Node SDK
Go SDK
Ruby SDK
Java SDK

curl -X POST https://api.privy.io/v1/intents/wallets/<wallet_id>/rpc \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "eth_sendTransaction",
    "caip2": "eip155:8453",
    "sponsor": "true",
    "params": {
      "transaction": {
        "to": "0xE3070d3e4309afA3bC9a6b057685743CF42da77C",
        "value": "0x2386F26FC10000"
      }
    }
  }'

import {PrivyClient, type EthereumSendTransactionRpcInput} from '@privy-io/node';

const client = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

const rpcRequest: EthereumSendTransactionRpcInput = {
  method: 'eth_sendTransaction',
  caip2: 'eip155:8453',
  sponsor: true,
  params: {
    transaction: {
      to: '0xE3070d3e4309afA3bC9a6b057685743CF42da77C',
      value: '0x2386F26FC10000'
    }
  }
};

const intent = await client.intents().rpc('insert-wallet-id', rpcRequest);

console.log(intent.intent_id, intent.status, intent.authorization_details);

import privy "github.com/privy-io/go-sdk"

client := privy.NewPrivyClient(privy.PrivyClientOptions{
    AppID:     "your-app-id",
    AppSecret: "your-app-secret",
})

transaction := privy.UnsignedStandardEthereumTransaction{
    To: privy.String("0xE3070d3e4309afA3bC9a6b057685743CF42da77C"),
    Value: privy.QuantityUnion{
        OfString: privy.String("0x2386F26FC10000"),
    },
}

rpcInput := &privy.EthereumSendTransactionRpcInput{
    Method: privy.EthereumSendTransactionRpcInputMethodEthSendTransaction,
    Caip2:  "eip155:8453",
    Params: privy.EthereumSendTransactionRpcInputParams{
        Transaction: transaction,
    },
}

intent, err := client.Intents.Rpc(ctx, "wallet-id", privy.IntentRpcParams{
    WalletRpcRequestBody: privy.WalletRpcRequestBodyUnion{
        OfEthSendTransaction: rpcInput,
    },
})

require "privy"

client = Privy::PrivyClient.new(
  app_id: "your-app-id",
  app_secret: "your-app-secret"
)

intent = client.intents.rpc(
  "wallet-id",
  wallet_rpc_request_body: {
    method: "eth_sendTransaction",
    caip2: "eip155:8453",
    params: {
      transaction: {
        to: "0xE3070d3e4309afA3bC9a6b057685743CF42da77C",
        value: "0x2386F26FC10000"
      }
    }
  }
)

puts(intent.intent_id, intent.status, intent.authorization_details)

import io.privy.api.PrivyClient;
import io.privy.api.models.components.*;
import io.privy.api.models.operations.IntentRpcResponse;

PrivyClient client = PrivyClient.builder()
    .appId("your-privy-app-id")
    .appSecret("your-app-secret")
    .build();

IntentRpcResponse intent = client.intents().rpc(
    "insert-wallet-id",
    EthereumSendTransactionRpcInput.builder()
        .method(EthereumSendTransactionRpcInputMethod.ETH_SEND_TRANSACTION)
        .caip2("eip155:8453")
        .sponsor(true)
        .params(EthereumSendTransactionRpcInputParams.builder()
            .transaction(UnsignedEthereumTransaction.of(UnsignedStandardEthereumTransaction.builder()
                .to("0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2")
                .value(Quantity.of("0x2386F26FC10000"))
                .build()))
            .build())
        .chainType(RpcChainType.ETHEREUM)
        .build(),
    null);

From the response, note the returned intent_id. View the API reference for submitting an RPC intent.

Signatures and transactions

Wallet actions

Signing and RPC

Intents

Transactions

Authorize a transaction

Next steps

Sign intents

Intent status

​Next steps

Sign intents

Intent status

Next steps