Bankr x402 SDK - Project Templates

x402 SDK Project Templates

Directory structures and templates for Bankr SDK projects using x402 micropayments.

Available Templates

Template	Use Case	Key Features
bot	Automated tasks	Polling loop, scheduler, transaction execution
web-service	HTTP APIs	REST endpoints, async handling, webhook support
dashboard	Web UIs	Frontend + backend, portfolio display
cli	Command-line tools	Subcommands, interactive prompts

Bot Template

For automated trading bots, price monitors, portfolio rebalancers, and scheduled tasks.

Directory Structure

{project-name}/
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
├── README.md
├── src/
│   ├── index.ts           # Main entry point with scheduler
│   ├── bankr-client.ts    # Bankr SDK client (from x402-client-patterns skill)
│   ├── executor.ts        # Transaction execution with viem/ethers
│   ├── types.ts           # TypeScript interfaces
│   └── config.ts          # Configuration loading
└── scripts/
    └── run.sh             # Convenience script

Key Features

• Polling loop: Configurable interval for recurring operations
• Transaction execution: Built-in viem integration for sending txs
• Status streaming: Real-time job progress updates
• Error handling: Automatic retries with backoff
• Graceful shutdown: Handles SIGINT/SIGTERM

Use Cases

• Price monitoring and alerts
• Automated swap strategies
• Portfolio rebalancing
• Scheduled market analysis
• DCA-like automation

Entry Point Pattern (index.ts)

import { bankrClient } from "./bankr-client";
import { executeTransaction } from "./executor";

const INTERVAL = 60000; // 1 minute

async function runBot() {
  console.log("Starting Bankr SDK bot...");

  while (true) {
    try {
      const result = await bankrClient.promptAndWait({
        prompt: "Check ETH price",
        onStatusUpdate: (msg) => console.log("Status:", msg),
      });

      if (result.status === "completed") {
        console.log("Result:", result.response);

        // Execute transactions if returned
        if (result.transactions?.length) {
          for (const tx of result.transactions) {
            await executeTransaction(tx);
          }
        }
      }
    } catch (error) {
      console.error("Error:", error);
    }

    await new Promise((r) => setTimeout(r, INTERVAL));
  }
}

runBot();