x402-client-patterns_skill

Overview

This skill provides reusable client code and common project files for integrating the Bankr x402 SDK in TypeScript projects. It includes a ready-to-use bankr-client.ts, a transaction executor using viem, and standard configuration files (package.json, tsconfig.json, .env.example, .gitignore). Use it to get a consistent, secure SDK client setup that handles micropayments, transaction execution, and environment validation.

How this skill works

The bankr-client.ts initializes a BankrClient using environment variables and re-exports wallet address and SDK types. The executor.ts maps chain IDs to viem chains, builds a wallet client from the private key, and exposes executeTransaction and executeAllTransactions helpers that submit transactions returned by the SDK. Common files provide build, run, and development scripts plus TypeScript and environment templates so projects start with a consistent structure.

When to use it

• Bootstrapping a new Bankr SDK TypeScript project or plugin
• Implementing bankr-client.ts or needing a uniform client pattern
• Executing on-chain transactions returned by the SDK with viem
• Creating package.json, tsconfig.json, and .env templates for SDK projects
• Building web services, CLIs, or scripts that call Bankr SDK endpoints

Best practices

• Keep BANKR_PRIVATE_KEY in a secure environment, never commit it to source control
• Fund the payment wallet with USDC on Base to cover $0.01 per request
• Validate chain IDs before execution and review transactions before sending
• Use onStatusUpdate callbacks to surface progress and errors to users
• Add framework-specific dependencies (Express, commander) only when needed

Example use cases

• Query token prices or balances via bankrClient.promptAndWait without executing transactions
• Perform swaps: request a swap from the SDK, inspect metadata, then execute with executeTransaction
• Automate batch flows: collect SDK responses and run executeAllTransactions to submit a sequence
• Build an Express endpoint that proxys prompts to Bankr SDK and returns responses
• Create a CLI tool (commander) that prompts the SDK and optionally executes returned txs