SettleRoute/DocsLaunch App
SettleRoute Documentation

Everything You Need to Know

From CSV format to smart contract ABI — complete reference for Web3 teams, DAOs, and developer integrations.

Quick Start

Upload a CSV, connect your wallet, and execute your first batch payout in under 60 seconds.

  • CSV format requirements
  • Wallet connection (MetaMask, Coinbase, Safe)
  • Selecting your token & network
  • Reviewing & executing a batch

CSV Format Reference

SettleRoute auto-maps common column names. Here are the supported formats.

  • Required columns: Address, Amount
  • Optional columns: Department / Category / Label
  • Supported delimiters: comma, semicolon, tab
  • Max rows per file: unlimited (auto-chunked)

Safe Multisig Integration

Use SettleRoute natively inside Safe Apps or export transaction manifests.

  • Loading as a custom Safe App
  • Exporting Safe Transaction Builder JSON
  • Proposing transactions to co-signers
  • Reviewing batch calldata before signing

Contractor Directory & Templates

Save payees to your on-device CRM and build recurring payroll templates.

  • Adding payees to the directory
  • Grouping by department
  • Creating recurring templates
  • Loading templates into a new batch

Webhook & ERP Integration

Automatically POST batch receipt data to n8n, Zapier, or any HTTP endpoint after execution.

  • Configuring your webhook endpoint URL
  • Batch receipt JSON payload schema
  • n8n workflow templates
  • Zapier integration guide

Smart Contract Reference

Direct smart contract documentation for developers and auditors.

  • Contract addresses by network
  • batchTransferToken function
  • EIP-2612 Permit flow
  • Fee calculation logic

CSV Format Requirements

SettleRoute auto-detects column names. Supported formats:

Minimal (required)

Address,Amount
0xabc...123,500
0xdef...456,250
0x789...abc,1000

Full (with department)

Address,Amount,Department
0xabc...123,500,Engineering
0xdef...456,250,Design
0x789...abc,1000,Marketing
Auto-mapped column names: Address / Wallet / To / Recipient | Amount / Value / USDC | Department / Category / Label / Tag

Webhook Payload Schema

After each successful batch execution, SettleRoute POSTs this JSON to your configured webhook URL:

{
  "event": "batch_executed",
  "timestamp": 1727568000,
  "chainId": 8453,
  "tokenSymbol": "USDC",
  "tokenAddress": "0x833589...",
  "totalAmount": "12500.00",
  "recipientCount": 25,
  "transactionHashes": ["0xabc...", "0xdef..."],
  "protocolFeeUsd": 10,
  "receipts": [
    {
      "address": "0x123...",
      "amount": "500.00",
      "category": "Engineering",
      "txHash": "0xabc..."
    }
  ]
}

Configure your webhook URL via the ⌘K Command Palette → “Configure Webhook” inside the app.

Smart Contract Addresses

Base Mainnet
Chain ID: 8453
0x1dD9881f...4B61cAView on Explorer ↗
Arbitrum One
Chain ID: 42161
0x1886eCba...8CB584View on Explorer ↗
Polygon
Chain ID: 137
0x1dD9881f...4B61cAView on Explorer ↗

Ready to execute your first batch?

Free for up to 5 recipients. No account required.

Launch SettleRoute