Sign & Submit API
Synchronous endpoints for signing and submitting transactions directly — no job polling required.
Endpoints
| Endpoint |
Purpose |
Returns |
POST /agent/sign |
Sign messages, typed data, or transactions |
Signature |
POST /agent/submit |
Submit raw transactions to chain |
Transaction hash |
POST /agent/sign
Signature Types
| Type |
Use Case |
personal_sign |
Plain text messages (auth, verification) |
eth_signTypedData_v4 |
EIP-712 typed data (permits, orders) |
eth_signTransaction |
Sign transactions for later broadcast |
Usage
// personal_sign
const signMessage = await fetch(`${API_URL}/agent/sign`, {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
signatureType: "personal_sign",
message: "Sign in to MyApp\nNonce: abc123",
}),
});
// → { success: true, signature: "0x...", signer: "0x...", signatureType: "personal_sign" }
// eth_signTypedData_v4 (EIP-2612 permit)
const signPermit = await fetch(`${API_URL}/agent/sign`, {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
signatureType: "eth_signTypedData_v4",
typedData: {
domain: { name: "USD Coin", version: "2", chainId: 8453, verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" },
types: {
Permit: [
{ name: "owner", type: "address" },
{ name: "spender", type: "address" },
{ name: "value", type: "uint256" },
{ name: "nonce", type: "uint256" },
{ name: "deadline", type: "uint256" },
],
},
primaryType: "Permit",
message: { owner: "0x...", spender: "0x...", value: "1000000", nonce: "0", deadline: "1735689600" },
},
}),
});
// eth_signTransaction
const signTx = await fetch(`${API_URL}/agent/sign`, {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
signatureType: "eth_signTransaction",
transaction: { to: "0x...", chainId: 8453, value: "0", data: "0xa9059cbb..." },
}),
});
Error Responses
| Status |
Error |
Cause |
| 400 |
Missing required field |
Missing message, typedData, or transaction |
| 401 |
Authentication required |
Missing or invalid API key |
| 403 |
Read-only API key |
Key lacks write permissions |
POST /agent/submit
Transaction Fields
| Field |
Type |
Required |
Description |
to |
string |
Yes |
Destination address |
chainId |
number |
Yes |
Chain ID (8453=Base, 1=Ethereum, 137=Polygon) |
value |
string |
No |
Value in wei |
data |
string |
No |
Calldata (hex) |
gas |
string |
No |
Gas limit |
maxFeePerGas |
string |
No |
EIP-1559 max fee |
maxPriorityFeePerGas |
string |
No |
EIP-1559 priority fee |
Options
| Field |
Type |
Default |
Description |
description |
string |
— |
Human-readable description for logging |
waitForConfirmation |
boolean |
true |
Wait for on-chain confirmation |
Usage
// Submit a transaction and wait for confirmation
const result = await fetch(`${API_URL}/agent/submit`, {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
transaction: { to: "0x...", chainId: 8453, value: "1000000000000000000" },
description: "Send 1 ETH",
waitForConfirmation: true,
}),
});
// → { success: true, transactionHash: "0x...", status: "success", blockNumber: "123", gasUsed: "21000" }
// Fire-and-forget (don't wait for confirmation)
const pending = await fetch(`${API_URL}/agent/submit`, {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
transaction: { to: "0x...", chainId: 8453, value: "100000000000000000" },
waitForConfirmation: false,
}),
});
// → { success: true, transactionHash: "0x...", status: "pending" }
Multi-Step Workflow
// Approve + Swap sequence
async function approveAndSwap(approveTx: object, swapTx: object) {
// 1. Approve token spending
const approval = await submitTransaction(approveTx);
if (approval.status !== "success") throw new Error("Approval failed");
// 2. Execute swap
const swap = await submitTransaction(swapTx);
if (swap.status !== "success") throw new Error("Swap failed");
return swap;
}
Transaction Status Values
| Status |
Description |
success |
Confirmed and succeeded |
reverted |
Confirmed but reverted |
pending |
Submitted, not yet confirmed |
Comparison with /agent/prompt
| Feature |
/agent/prompt |
/agent/sign |
/agent/submit |
| Input |
Natural language |
Structured data |
Transaction object |
| Response |
Async (job ID) |
Sync (signature) |
Sync (tx hash) |
| Executes on-chain |
Via AI agent |
No |
Yes |
| Best for |
General queries |
Auth, permits |
Raw transactions |
Security Notes
/agent/submit executes immediately — no confirmation prompt
- Read-only API keys get 403 on both endpoints
- Always validate transaction parameters before submission
- Use
waitForConfirmation: true for critical transactions
Related Skills
bankr-api-basics - API fundamentals
bankr-client-patterns - Client setup
bankr-safety - Security best practices
bankr-arbitrary-transaction - Constructing raw transaction JSON
1---2name: bankr-dev-sign-submit-api3description: This skill should be used when building apps that need to sign messages, sign typed data (EIP-712), sign transactions, or submit raw transactions via the Bankr API. Covers the synchronous /agent/sign and /agent/submit endpoints with TypeScript patterns.4version: 1.0.05metadata:6 source: https://skillmd.com/skills/enuno/bankr-dev-sign-submit-api7---89# Sign & Submit API1011Synchronous endpoints for signing and submitting transactions directly — no job polling required.1213## Endpoints1415| Endpoint | Purpose | Returns |16|----------|---------|---------|17| `POST /agent/sign` | Sign messages, typed data, or transactions | Signature |18| `POST /agent/submit` | Submit raw transactions to chain | Transaction hash |1920## POST /agent/sign2122### Signature Types2324| Type | Use Case |25|------|----------|26| `personal_sign` | Plain text messages (auth, verification) |27| `eth_signTypedData_v4` | EIP-712 typed data (permits, orders) |28| `eth_signTransaction` | Sign transactions for later broadcast |2930### Usage3132```typescript33// personal_sign34const signMessage = await fetch(`${API_URL}/agent/sign`, {35 method: "POST",36 headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },37 body: JSON.stringify({38 signatureType: "personal_sign",39 message: "Sign in to MyApp\nNonce: abc123",40 }),41});42// → { success: true, signature: "0x...", signer: "0x...", signatureType: "personal_sign" }4344// eth_signTypedData_v4 (EIP-2612 permit)45const signPermit = await fetch(`${API_URL}/agent/sign`, {46 method: "POST",47 headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },48 body: JSON.stringify({49 signatureType: "eth_signTypedData_v4",50 typedData: {51 domain: { name: "USD Coin", version: "2", chainId: 8453, verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" },52 types: {53 Permit: [54 { name: "owner", type: "address" },55 { name: "spender", type: "address" },56 { name: "value", type: "uint256" },57 { name: "nonce", type: "uint256" },58 { name: "deadline", type: "uint256" },59 ],60 },61 primaryType: "Permit",62 message: { owner: "0x...", spender: "0x...", value: "1000000", nonce: "0", deadline: "1735689600" },63 },64 }),65});6667// eth_signTransaction68const signTx = await fetch(`${API_URL}/agent/sign`, {69 method: "POST",70 headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },71 body: JSON.stringify({72 signatureType: "eth_signTransaction",73 transaction: { to: "0x...", chainId: 8453, value: "0", data: "0xa9059cbb..." },74 }),75});76```7778### Error Responses7980| Status | Error | Cause |81|--------|-------|-------|82| 400 | Missing required field | Missing message, typedData, or transaction |83| 401 | Authentication required | Missing or invalid API key |84| 403 | Read-only API key | Key lacks write permissions |8586## POST /agent/submit8788### Transaction Fields8990| Field | Type | Required | Description |91|-------|------|----------|-------------|92| `to` | string | Yes | Destination address |93| `chainId` | number | Yes | Chain ID (8453=Base, 1=Ethereum, 137=Polygon) |94| `value` | string | No | Value in wei |95| `data` | string | No | Calldata (hex) |96| `gas` | string | No | Gas limit |97| `maxFeePerGas` | string | No | EIP-1559 max fee |98| `maxPriorityFeePerGas` | string | No | EIP-1559 priority fee |99100### Options101102| Field | Type | Default | Description |103|-------|------|---------|-------------|104| `description` | string | — | Human-readable description for logging |105| `waitForConfirmation` | boolean | true | Wait for on-chain confirmation |106107### Usage108109```typescript110// Submit a transaction and wait for confirmation111const result = await fetch(`${API_URL}/agent/submit`, {112 method: "POST",113 headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },114 body: JSON.stringify({115 transaction: { to: "0x...", chainId: 8453, value: "1000000000000000000" },116 description: "Send 1 ETH",117 waitForConfirmation: true,118 }),119});120// → { success: true, transactionHash: "0x...", status: "success", blockNumber: "123", gasUsed: "21000" }121122// Fire-and-forget (don't wait for confirmation)123const pending = await fetch(`${API_URL}/agent/submit`, {124 method: "POST",125 headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },126 body: JSON.stringify({127 transaction: { to: "0x...", chainId: 8453, value: "100000000000000000" },128 waitForConfirmation: false,129 }),130});131// → { success: true, transactionHash: "0x...", status: "pending" }132```133134### Multi-Step Workflow135136```typescript137// Approve + Swap sequence138async function approveAndSwap(approveTx: object, swapTx: object) {139 // 1. Approve token spending140 const approval = await submitTransaction(approveTx);141 if (approval.status !== "success") throw new Error("Approval failed");142143 // 2. Execute swap144 const swap = await submitTransaction(swapTx);145 if (swap.status !== "success") throw new Error("Swap failed");146147 return swap;148}149```150151### Transaction Status Values152153| Status | Description |154|--------|-------------|155| `success` | Confirmed and succeeded |156| `reverted` | Confirmed but reverted |157| `pending` | Submitted, not yet confirmed |158159## Comparison with /agent/prompt160161| Feature | /agent/prompt | /agent/sign | /agent/submit |162|---------|---------------|-------------|---------------|163| Input | Natural language | Structured data | Transaction object |164| Response | Async (job ID) | Sync (signature) | Sync (tx hash) |165| Executes on-chain | Via AI agent | No | Yes |166| Best for | General queries | Auth, permits | Raw transactions |167168## Security Notes169170- `/agent/submit` executes immediately — **no confirmation prompt**171- Read-only API keys get 403 on both endpoints172- Always validate transaction parameters before submission173- Use `waitForConfirmation: true` for critical transactions174175## Related Skills176177- `bankr-api-basics` - API fundamentals178- `bankr-client-patterns` - Client setup179- `bankr-safety` - Security best practices180- `bankr-arbitrary-transaction` - Constructing raw transaction JSON