Full Integration Guide

Summary

DA Builder supports two EIP-7702 integration paths: TrustedProposer for fast setup and TrustlessProposer for account-owner authorization on every delegated call.

Choose An Integration Path

Start with TrustedProposer unless your application already requires account-owner authorization for every delegated call.

Path	Use this when	Do not use this when	Integration work	Security model
`TrustedProposer`	You need the fastest way to test DA Builder with a dedicated EOA	The EOA controls assets, admin permissions, or protocol authority	Delegate to Spire’s `TrustedProposer`, switch RPC, fund GasTank	The EOA trusts Spire’s DA Builder service with delegated execution
`TrustlessProposer`	Every delegated call must be authorized by the account owner	You need a no-code or minimal-code trial	Delegate to `TrustlessProposer`, switch RPC, fund GasTank, sign EIP-712 proposer payloads	DA Builder aggregates calls, but the proposer contract verifies owner authorization before execution

Network Configuration

Network	TrustedProposer	TrustlessProposer	GasTank	RPC
Mainnet	`0xC09f597034f654283a05B058EE1306534b837868`	`0x1b3068A7dC934cCEBF7784cBd9266D80948a98A1`	`0x2565c0A726cB0f2F79cd16510c117B4da6a6534b`	`https://da-builder.mainnet.spire.dev/`
Sepolia	`0x9ccc2f3ecdE026230e11a5c8799ac7524f2bb294`	`0x51922A1e2A010418bD709870Cd1ff13615070fa8`	`0x18Fa15ea0A34a7c4BCA01bf7263b2a9Ac0D32e92`	`https://da-builder.sepolia.spire.dev/`

TrustedProposer Workflow

TrustedProposer is the fastest way to use DA Builder. The transaction sender can keep submitting normal signed transactions after setup.

Create or choose a dedicated EOA.
Deposit ETH into the Spire GasTank for that EOA.
Submit an EIP-7702 authorization that delegates the EOA to Spire’s TrustedProposer.
Send transaction submissions to the DA Builder RPC endpoint.
Store the returned transaction hash.
Poll eth_getTransactionReceipt or dab_transactionStatus.
Use direct RPC fallback for outages, unsupported methods, or non-aggregated operational paths.

TrustedProposer Delegation With Foundry

#!/usr/bin/env bash
set -euo pipefail

RPC_URL="https://da-builder.mainnet.spire.dev/"
DELEGATE="0xC09f597034f654283a05B058EE1306534b837868"

SIGNED_AUTH="$(cast wallet sign-auth "$DELEGATE" \
  --private-key "$EOA_PK" \
  --rpc-url "$RPC_URL")"

cast send "$(cast az)" \
  --private-key "$EOA_PK" \
  --auth "$SIGNED_AUTH" \
  --rpc-url "$RPC_URL"

TrustlessProposer Workflow

TrustlessProposer is for applications that need DA Builder aggregation without trusting Spire to choose arbitrary delegated execution.

Delegate the EOA to TrustlessProposer.
Fund the Spire GasTank.
Update the application to sign proposer call payloads.
Submit the signed proposer call through DA Builder.
Poll status and implement direct RPC fallback.

IProposer Interface

interface IProposer {
    function onCall(address _target, bytes calldata _data, uint256 _value) external returns (bool);
}

TrustlessProposer Security Requirements

Requirement	Purpose
EIP-712 signature	Confirms the account owner authorized the delegated call
Nonce	Prevents replay attacks
Deadline	Prevents stale transactions
Gas limit	Prevents unexpected delegated execution cost
Fixed storage layout	Reduces EIP-7702 storage collision risk when account code changes

For a complete implementation, see TrustlessProposer.sol↗.

TrustlessProposer Delegation With Foundry

#!/usr/bin/env bash
set -euo pipefail

RPC_URL="https://da-builder.mainnet.spire.dev/"
DELEGATE="0x1b3068A7dC934cCEBF7784cBd9266D80948a98A1"

SIGNED_AUTH="$(cast wallet sign-auth "$DELEGATE" \
  --private-key "$EOA_PK" \
  --rpc-url "$RPC_URL")"

cast send "$(cast az)" \
  --private-key "$EOA_PK" \
  --auth "$SIGNED_AUTH" \
  --rpc-url "$RPC_URL"

TrustlessProposer Example Call

This example builds the exact calldata shape used by TrustlessProposer.onCall(...) and uses ethers v6.

import { AbiCoder, Interface, Wallet, ethers } from "ethers";

const trustlessProposerAbi = [
  "function nestedNonce() view returns (uint256)",
  "function onCall(address target, bytes data, uint256 value) returns (bool)",
];

const greeterAbi = ["function setGreeting(string greeting)"];

const provider = new ethers.JsonRpcProvider(process.env.RPC_URL);
const signer = new Wallet(process.env.PRIVATE_KEY!, provider);

const trustlessProposerAddress = "0x1b3068A7dC934cCEBF7784cBd9266D80948a98A1";
const greeterAddress = "0xYourPublicGreeterAddress";
const chainId = 1;
const gasLimit = 1_000_000n;
const deadline = 999_999_999_999n;
const value = 0n;

const trustlessProposer = new ethers.Contract(
  trustlessProposerAddress,
  trustlessProposerAbi,
  provider,
);

const greeter = new Interface(greeterAbi);
const greeting = "hello from DA Builder";
const calldata = greeter.encodeFunctionData("setGreeting", [greeting]);
const nonce = await trustlessProposer.nestedNonce();

// The signer must control the delegated EOA.
const signature = await signer.signTypedData(
  {
    name: "TrustlessProposer",
    version: "1",
    chainId,
    verifyingContract: trustlessProposerAddress,
  },
  {
    Call: [
      { name: "deadline", type: "uint256" },
      { name: "nonce", type: "uint256" },
      { name: "target", type: "address" },
      { name: "value", type: "uint256" },
      { name: "calldata", type: "bytes" },
      { name: "gasLimit", type: "uint256" },
    ],
  },
  {
    deadline,
    nonce,
    target: greeterAddress,
    value,
    calldata,
    gasLimit,
  },
);

const encodedData = AbiCoder.defaultAbiCoder().encode(
  ["bytes", "uint256", "uint256", "bytes", "uint256"],
  [signature, deadline, nonce, calldata, gasLimit],
);

const functionCall = new Interface(trustlessProposerAbi).encodeFunctionData("onCall", [
  greeterAddress,
  encodedData,
  value,
]);

const tx = await signer.sendTransaction({
  to: trustlessProposerAddress,
  data: functionCall
});

const receipt = await tx.wait();
console.log(receipt?.status);

Next Steps

Quick Reference - Endpoints, methods, examples, and auth.
Architecture - Component responsibilities and trust boundaries.
Monitor Account - Balance and status monitoring.
AI Agent Integration - Instructions for autonomous coding agents.

​Summary

​Choose An Integration Path

​Network Configuration

​TrustedProposer Workflow

​TrustedProposer Delegation With Foundry

​TrustlessProposer Workflow

​IProposer Interface

​TrustlessProposer Security Requirements

​TrustlessProposer Delegation With Foundry

​TrustlessProposer Example Call

​Next Steps