@agentsbank/sdk 1.0.8 → 1.0.12

package/.env.example

@@ -0,0 +1,53 @@
+# AgentsBank SDK - Environment Variables Template
+# Copy this to .env and fill in your actual credentials
+# SECURITY WARNING: Never commit .env to version control
+
+# ============================================
+# API Configuration (REQUIRED)
+# ============================================
+# Base URL of AgentsBank API
+# For local development: http://localhost:3000
+# For production: https://api.agentsbank.online
+AGENTSBANK_API_URL=https://api.agentsbank.online
+
+# ============================================
+# Authentication (Choose ONE method)
+# ============================================
+
+# METHOD 1: API Key (Recommended for production)
+AGENTSBANK_API_KEY=your-api-key-here-do-not-share
+
+# METHOD 2: Agent Credentials (For testing/setup)
+# Uncomment and fill only if using credential-based auth
+# AGENTSBANK_AGENT_USERNAME=agent_name
+# AGENTSBANK_AGENT_PASSWORD=agent_password_secret
+
+# ============================================
+# Optional: Pre-authenticated Token
+# ============================================
+# Only needed if you have a pre-issued JWT token
+# AGENTSBANK_AUTH_TOKEN=jwt-token-here
+
+# ============================================
+# Optional: Runtime Configuration
+# ============================================
+# Environment: 'production' or 'sandbox'
+AGENTSBANK_ENVIRONMENT=production
+
+# Request timeout in milliseconds
+AGENTSBANK_TIMEOUT_MS=10000
+
+# Enable audit logging
+AGENTSBANK_AUDIT_LOG=true
+
+# Webhook URL for transaction notifications (optional)
+# AGENTSBANK_WEBHOOK_URL=https://your-domain.com/webhooks/agentsbank
+
+# ============================================
+# Security Checklist
+# ============================================
+# ✓ API key obtained from https://dashboard.agentsbank.ai
+# ✓ Never commit this file to git (add to .gitignore)
+# ✓ Rotate API key monthly or when team member leaves
+# ✓ Use different credentials for development vs production
+# ✓ Enable audit logging in production

package/CHANGELOG.md

@@ -5,37 +5,72 @@ All notable changes to the AgentsBank SDK are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.8] - 2026-02-14
+## [1.0.12] - 2026-02-14
+
+### Fixed
+- **CRITICAL**: Fixed MODULE_NOT_FOUND error by ensuring dist/ folder is built before publishing
+- Proper TypeScript compilation and dist/ folder generation in NPM package
+- Package now correctly includes compiled index.js and type definitions
+
+### Changed
+- Updated tsconfig.json to properly compile SDK source files
+- Reorganized package build process
+
+---
+
+## [1.0.11] - 2026-02-14
+
+### Added
+- **Autonomous Mode Support**: Added optional `autonomousMode` config flag for trusted agents
+  - Allows financial transactions without `UserApprovalContext` when explicitly enabled
+  - Maintains security by requiring guardrails (spending limits, audit logging, whitelisting)
+  - Still generates audit trail with synthetic approval context for compliance
+
+### Changed
+- Updated all domain references from `agentsbank.ai` to `agentsbank.online`
+- Improved security documentation to reflect default-secure-but-flexible approach
+- Enhanced README with Autonomous Mode best practices section
 
 ### Fixed
-- **Critical**: Fixed all SDK endpoint paths to include `/api` prefix for compatibility with backend routing
-  - `/auth/agent/login` → `/api/auth/agent/login`
-  - `/wallets` → `/api/wallets`
-  - `/transactions` → `/api/transactions`
-  - All wallet, transaction, and auth endpoints updated
-- **Enhanced error handling**: Added response interceptor to provide detailed error messages
-  - API errors now show status codes and endpoint URLs
-  - Network errors provide guidance on API availability
-  - Authentication errors suggest credential verification
-- **SDK configuration**: Updated default API URL from `api.agentsbank.ai` to `api.agentsbank.online`
-- **Login error messages**: Improved authentication error feedback with specific guidance
-- **NPM Publishing**: Added public access configuration for scoped package
+- Type definitions now support `'autonomous'` approval method
+- Response error interceptor provides better error messages
+- Network connectivity detection with helpful guidance
+
+### Documentation
+- Updated all API endpoint examples to use `api.agentsbank.online`
+- Added comprehensive Autonomous Mode setup guide
+- Enhanced security requirements section with dual-mode explanation
+- Updated all support links to `agentsbank.online`
+
+---
+
+## [1.0.10] - 2026-02-14
 
 ### Added
-- Response error interceptor for better debugging experience
-- Network error detection with "API might be offline" message
-- Endpoint URL in error messages for easier troubleshooting
-- Public access configuration in package.json
+- **Autonomous Mode Support**: Added optional `autonomousMode` config flag for trusted agents
+  - Allows financial transactions without `UserApprovalContext` when explicitly enabled
+  - Maintains security by requiring guardrails (spending limits, audit logging, whitelisting)
+  - Still generates audit trail with synthetic approval context for compliance
 
-### Security
-- No changes to security constraints. SDK continues to require:
-  - Explicit API credentials (apiUrl + apiKey or agent credentials)
-  - UserApprovalContext for financial operations
-  - Audit logging for all transactions
+### Changed
+- Updated all domain references from `agentsbank.ai` to `agentsbank.online`
+- Improved security documentation to reflect default-secure-but-flexible approach
+- Enhanced README with Autonomous Mode best practices section
+
+### Fixed
+- Type definitions now support `'autonomous'` approval method
+- Response error interceptor provides better error messages
+- Network connectivity detection with helpful guidance
+
+### Documentation
+- Updated all API endpoint examples to use `api.agentsbank.online`
+- Added comprehensive Autonomous Mode setup guide
+- Enhanced security requirements section with dual-mode explanation
+- Updated all support links to `agentsbank.online`
 
 ---
 
-## [1.0.7] - 2026-02-14
+## [1.0.8] - 2026-02-14
 
 ### Fixed
 - Fixed SDK endpoint paths to include `/api` prefix

package/README.md

@@ -2,9 +2,13 @@
 
 ## ⚠️ Critical Security Requirements
 
-This SDK manages **real financial transactions** on blockchain networks. It is **not autonomously invocable** and requires explicit human approval for all financial operations.
+This SDK manages **real financial transactions** on blockchain networks. 
+
+**Default Mode**: Requires explicit human approval for all financial operations via `UserApprovalContext`.
+
+**Autonomous Mode** (Optional): Can be enabled for trusted agents via `autonomousMode: true` config flag. Requires strict guardrails (spending limits, whitelisting, audit logging) to prevent unauthorized transactions.
+
 
----
 
 ## 📋 Credential Checklist
 
@@ -29,7 +33,7 @@ npm install @agentsbank/sdk
 
 ### Setup
 
-1. **Get credentials** from https://dashboard.agentsbank.ai
+1. **Get credentials** from https://dashboard.agentsbank.online
 2. **Copy environment template**:
    ```bash
    cp .env.example .env
@@ -123,6 +127,41 @@ const confirmed = await bank.waitForConfirmation(
 console.log('Final status:', confirmed.status); // 'confirmed' | 'failed'
 ```
 
+### 🚀 Autonomous Mode (Advanced)
+
+**For trusted autonomous agents only** - allows financial operations without human approval.
+
+```typescript
+// Initialize with autonomous mode enabled
+const autonomousBank = new AgentsBankSDK({
+  apiUrl: process.env.AGENTSBANK_API_URL!,
+  apiKey: process.env.AGENTSBANK_API_KEY!,
+  autonomousMode: true,  // ⚠️  Enable autonomous execution
+  auditLogger: (event) => {
+    console.log(`[AUTONOMOUS] ${event.operation}`, event);
+  }
+});
+
+// Now transactions can execute without UserApprovalContext
+const transaction = await autonomousBank.sendTransaction(
+  walletId,
+  '0xRecipient...',
+  '1.5',
+  undefined,  // ← No approval needed in autonomous mode
+  'ETH'
+);
+
+// ✅ Still logs as 'agent_autonomous_...' for audit trail
+console.log('Autonomous Transaction ID:', transaction.tx_id);
+```
+
+**⚠️  Security Requirements for Autonomous Mode:**
+- Guardrails MUST be configured (max daily spend, transaction limits, whitelist)
+- Audit logging MUST be enabled
+- Should be used only for time-sensitive agent operations
+- Spending limits should be conservative
+- Agent should have read-only access to limited wallets
+
 ---
 
 ## 🔑 Authentication Methods
@@ -131,7 +170,7 @@ console.log('Final status:', confirmed.status); // 'confirmed' | 'failed'
 
 ```typescript
 const bank = new AgentsBankSDK({
-  apiUrl: 'https://api.agentsbank.ai',
+  apiUrl: 'https://api.agentsbank.online',
   apiKey: process.env.AGENTSBANK_API_KEY, // From dashboard
 });
 ```
@@ -140,7 +179,7 @@ const bank = new AgentsBankSDK({
 
 ```typescript
 const bank = new AgentsBankSDK({
-  apiUrl: 'https://api.agentsbank.ai',
+  apiUrl: 'https://api.agentsbank.online',
   agentUsername: process.env.AGENTSBANK_AGENT_USERNAME,
   agentPassword: process.env.AGENTSBANK_AGENT_PASSWORD,
 });
@@ -153,7 +192,7 @@ const token = await bank.login();
 
 ```typescript
 const bank = new AgentsBankSDK({
-  apiUrl: 'https://api.agentsbank.ai',
+  apiUrl: 'https://api.agentsbank.online',
   token: process.env.AGENTSBANK_AUTH_TOKEN, // JWT from previous auth
 });
 ```
@@ -175,11 +214,11 @@ echo ".env.*.local" >> .gitignore
 
 ```bash
 # development
-AGENTSBANK_API_URL=https://sandbox.agentsbank.ai
+AGENTSBANK_API_URL=https://sandbox.agentsbank.online
 AGENTSBANK_API_KEY=sk_sandbox_...
 
 # production
-AGENTSBANK_API_URL=https://api.agentsbank.ai
+AGENTSBANK_API_URL=https://api.agentsbank.online
 AGENTSBANK_API_KEY=sk_prod_...
 ```
 
@@ -325,10 +364,10 @@ All SDK operations are logged with:
 
 ## 📞 Support
 
-- **Documentation**: https://docs.agentsbank.ai
-- **Dashboard**: https://dashboard.agentsbank.ai
-- **Status Page**: https://status.agentsbank.ai
-- **Security Issues**: security@agentsbank.ai
+- **Documentation**: https://docs.agentsbank.online
+- **Dashboard**: https://dashboard.agentsbank.online
+- **Status Page**: https://status.agentsbank.online
+- **Security Issues**: security@agentsbank.online
 
 ---
 

package/dist/index.d.ts

@@ -0,0 +1,172 @@
+/**
+ * 🔒 AgentsBank.ai SDK for Agents - FINANCIAL OPERATIONS
+ *
+ * ⚠️  SECURITY CONSTRAINTS:
+ * - Requires explicit API credentials (apiUrl + apiKey or agent credentials)
+ * - Financial operations (sendTransaction) require UserApprovalContext
+ * - NOT autonomously invocable - requires human approval
+ * - All operations logged with audit trail
+ *
+ * Usage:
+ * import { AgentsBankSDK } from '@agentsbank/sdk';
+ *
+ * const bank = new AgentsBankSDK({
+ *   apiUrl: process.env.AGENTSBANK_API_URL!,
+ *   apiKey: process.env.AGENTSBANK_API_KEY!,
+ * });
+ *
+ * // Read-only operations (no approval needed)
+ * const wallet = await bank.getWallet(walletId);
+ *
+ * // Financial operations (REQUIRES USER APPROVAL)
+ * const tx = await bank.sendTransaction(
+ *   walletId,
+ *   toAddress,
+ *   amount,
+ *   { userId: 'user_123', approvedAt: new Date(), reason: 'User confirmed on UI' }
+ * );
+ */
+/**
+ * ⚠️  REQUIRED: User approval context for financial operations
+ * Prevents autonomous execution of transactions
+ */
+export interface UserApprovalContext {
+    userId: string;
+    approvedAt: Date;
+    reason?: string;
+    approvalMethod?: 'ui' | 'api' | '2fa' | 'autonomous';
+}
+export interface SDKConfig {
+    apiUrl: string;
+    agentUsername?: string;
+    agentPassword?: string;
+    apiKey?: string;
+    token?: string;
+    auditLogger?: (event: AuditEvent) => void;
+    /**
+     * ⚠️  AUTONOMOUS MODE (RISKY)
+     * If true, allows financial operations without UserApprovalContext
+     * Use only for trusted autonomous agents with guardrails enabled
+     * Default: false (requires human approval)
+     */
+    autonomousMode?: boolean;
+}
+export interface AuditEvent {
+    timestamp: Date;
+    operation: 'wallet_create' | 'wallet_list' | 'balance_query' | 'transaction_send' | 'auth_login' | 'token_refresh';
+    walletId?: string;
+    txId?: string;
+    userId?: string;
+    amount?: string;
+    toAddress?: string;
+    status: 'initiated' | 'success' | 'failed';
+    error?: string;
+}
+export interface WalletInfo {
+    wallet_id: string;
+    agent_id: string;
+    chain: string;
+    address: string;
+    type: 'custodial' | 'non-custodial';
+    balance: Record<string, string>;
+    created_at: string;
+}
+export interface TransactionInfo {
+    tx_id: string;
+    wallet_id: string;
+    type: string;
+    amount: string;
+    currency: string;
+    from_address: string;
+    to_address: string;
+    tx_hash?: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    fee: string;
+    timestamp: string;
+}
+export declare class AgentsBankSDK {
+    private client;
+    private config;
+    private token?;
+    private auditLogger;
+    constructor(config: SDKConfig);
+    /**
+     * Default audit logger - logs to console (override with custom logger)
+     */
+    private defaultAuditLogger;
+    /**
+     * Internal audit logging
+     */
+    private logAudit;
+    /**
+     * Login with agent credentials
+     */
+    login(): Promise<string>;
+    /**
+     * Create a new wallet
+     */
+    createWallet(chain: 'ethereum' | 'bsc' | 'solana', type?: 'custodial' | 'non-custodial'): Promise<WalletInfo>;
+    /**
+     * Get wallet details
+     */
+    getWallet(walletId: string): Promise<WalletInfo>;
+    /**
+     * List all wallets for agent
+     */
+    listWallets(): Promise<WalletInfo[]>;
+    /**
+     * Get wallet balance
+     */
+    getBalance(walletId: string): Promise<Record<string, string>>;
+    /**
+     * Estimate gas for transaction
+     */
+    estimateGas(walletId: string, toAddress: string, amount: string): Promise<{
+        estimated_gas: string;
+    }>;
+    /**
+     * ⚠️  FINANCIAL OPERATION: Send transaction
+     *
+     * DEFAULT: Requires UserApprovalContext with human approval evidence
+     * - Prevents autonomous execution by default
+     * - Requires userId of approver and approval timestamp
+     * - All transactions logged in audit trail
+     *
+     * AUTONOMOUS MODE: If enabled in SDKConfig, can run without approval
+     * - Use only for trusted autonomous agents with guardrails
+     * - Still requires audit logging and guardrails validation
+     *
+     * @param walletId Source wallet ID
+     * @param toAddress Recipient blockchain address
+     * @param amount Transaction amount
+     * @param approval User approval context (OPTIONAL if autonomousMode enabled)
+     * @param currency Asset to transfer (default: ETH)
+     */
+    sendTransaction(walletId: string, toAddress: string, amount: string, approval?: UserApprovalContext, currency?: string): Promise<TransactionInfo>;
+    /**
+     * Get transaction details
+     */
+    getTransaction(txId: string): Promise<TransactionInfo>;
+    /**
+     * Get transaction history for wallet
+     */
+    getTransactionHistory(walletId: string, limit?: number): Promise<TransactionInfo[]>;
+    /**
+     * Get transaction statistics
+     */
+    getStats(walletId: string, days?: number): Promise<any>;
+    /**
+     * Wait for transaction to be confirmed
+     */
+    waitForConfirmation(txId: string, maxWaitMs?: number, pollIntervalMs?: number): Promise<TransactionInfo>;
+    /**
+     * Update API key
+     */
+    regenerateApiKey(): Promise<string>;
+    /**
+     * Refresh JWT token
+     */
+    refreshToken(): Promise<string>;
+}
+export default AgentsBankSDK;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}