使用权限执行交易

用户通过 wallet_requestExecutionPermissions 授权后，Session Account（to 地址）可调用 DelegationManager 的 redeemDelegations，在权限约束内代用户执行链上操作。本节说明如何构造并发送 redeem 交易。

前置条件

1. 已获得 PermissionResponse（含 context、delegationManager）。

2. Session Account 私钥可用，且地址等于授权中的 to。

3. 执行链与授权 chainId 一致。

核心合约接口（EIP-7710）

function redeemDelegations(
  bytes[] calldata permissionContexts,
  bytes32[] calldata modes,
  bytes[] calldata executionCallDatas
) external;

参数	说明
permissionContexts	[grant.context]
modes	执行模式，单笔默认 0x0000...0000（32 字节零）
executionCallDatas	编码后的 Execution 结构

Execution 编码

struct Execution {
  address target;
  uint256 value;
  bytes callData;
}

编码方式

function encodeSingleExecution(execution: {
  target: `0x${string}`;
  value: bigint;
  callData: `0x${string}`;
}) {
  const target = execution.target.slice(2).toLowerCase().padStart(40, "0");
  const value = execution.value.toString(16).padStart(64, "0");
  const data = execution.callData.slice(2);
  return `0x${target}${value}${data}` as `0x${string}`;
}

按权限类型构造 Execution

ERC-20 转账

import { encodeFunctionData, parseUnits } from "viem";

const tokenAddress = grant.permission.data.tokenAddress;
const amount = parseUnits("1", 18);

const execution = {
  target: tokenAddress,
  value: 0n,
  callData: encodeFunctionData({
    abi: [
      {
        type: "function",
        name: "transfer",
        inputs: [
          { name: "to", type: "address" },
          { name: "amount", type: "uint256" },
        ],
        outputs: [{ type: "bool" }],
        stateMutability: "nonpayable",
      },
    ],
    functionName: "transfer",
    args: [payeeAddress, amount],
  }),
};

原生币转账

const execution = {
  target: payeeAddress,
  value: parseUnits("0.001", 18),
  callData: "0x",
};

完整 Redeem 示例

使用 viem 构造 calldata 并由 Session Account 发送交易：

import { createWalletClient, http, encodeFunctionData, parseUnits } from "viem";
import { privateKeyToAccount } from "viem/accounts";

const SINGLE_DEFAULT_MODE =
  "0x0000000000000000000000000000000000000000000000000000000000000000";

const DELEGATION_MANAGER_ABI = [
  {
    type: "function",
    name: "redeemDelegations",
    inputs: [
      { name: "permissionContexts", type: "bytes[]" },
      { name: "modes", type: "bytes32[]" },
      { name: "executionCallDatas", type: "bytes[]" },
    ],
    outputs: [],
    stateMutability: "nonpayable",
  },
];

function encodeSingleExecution(execution: {
  target: `0x${string}`;
  value: bigint;
  callData: `0x${string}`;
}) {
  const target = execution.target.slice(2).toLowerCase().padStart(40, "0");
  const value = execution.value.toString(16).padStart(64, "0");
  const data = execution.callData.slice(2);
  return `0x${target}${value}${data}` as `0x${string}`;
}

async function redeemErc20Transfer(
  grant: PermissionResponse,
  payee: `0x${string}`,
  humanAmount: string,
  rpcUrl: string,
) {
  const sessionAccount = privateKeyToAccount(
    process.env.SESSION_PRIVATE_KEY as `0x${string}`,
  );

  if (sessionAccount.address.toLowerCase() !== grant.to.toLowerCase()) {
    throw new Error("Session 地址与授权 to 不一致");
  }

  const decimals = 18; // 需要根据实际 ERC-20 合约读取 decimals
  const amount = parseUnits(humanAmount, decimals);
  const tokenAddress = grant.permission.data.tokenAddress as `0x${string}`;

  const executionCallData = encodeSingleExecution({
    target: tokenAddress,
    value: 0n,
    callData: encodeFunctionData({
      abi: [
        {
          type: "function",
          name: "transfer",
          inputs: [{ type: "address" }, { type: "uint256" }],
          outputs: [{ type: "bool" }],
          stateMutability: "nonpayable",
        },
      ],
      functionName: "transfer",
      args: [payee, amount],
    }),
  });

  const data = encodeFunctionData({
    abi: DELEGATION_MANAGER_ABI,
    functionName: "redeemDelegations",
    args: [[grant.context], [SINGLE_DEFAULT_MODE], [executionCallData]],
  });

  const chainId = parseInt(grant.chainId, 16);

  const client = createWalletClient({
    account: sessionAccount,
    chain: {
      id: chainId,
      name: `Chain ${chainId}`,
      nativeCurrency: { name: "Native", symbol: "Native", decimals: 18 },
      rpcUrls: { default: { http: [rpcUrl] } },
    },
    transport: http(rpcUrl),
  });

  return client.sendTransaction({
    to: grant.delegationManager,
    value: 0n,
    data,
  });
}

执行前检查清单

检查项	说明
to 地址匹配	签名者 = grant.to
链 ID 一致	必要时 wallet_switchEthereumChain
额度充足	periodic/stream 规则 + 链上 enforcer
context 有效	未过期、未撤销
dependencies 已部署	factory 部署完成后再 redeem