@toon-protocol/connector 1.7.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 M2M Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,421 @@
+# @toon-protocol/connector
+
+[![npm](https://img.shields.io/npm/v/@toon-protocol/connector)](https://www.npmjs.com/package/@toon-protocol/connector)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+
+> ILP connector node for AI agent payment networks. Routes packets, tracks balances, settles on-chain.
+
+See the [root README](../../README.md) for conceptual overview, network architecture, and Docker deployment.
+
+## Install
+
+```bash
+npm install @toon-protocol/connector
+```
+
+## Quick Start
+
+```typescript
+import { ConnectorNode, createLogger } from '@toon-protocol/connector';
+
+const node = new ConnectorNode('config.yaml', createLogger('my-agent', 'info'));
+
+node.setPacketHandler(async (request) => {
+  console.log(`Received ${request.amount} tokens`);
+  return { accept: true };
+});
+
+await node.start();
+```
+
+## Deployment Modes
+
+The connector supports two deployment modes via `deploymentMode` in config:
+
+| Mode           | Value          | How packets arrive            | How packets are sent           |
+| -------------- | -------------- | ----------------------------- | ------------------------------ |
+| **Embedded**   | `'embedded'`   | `setPacketHandler()` callback | `node.sendPacket()`            |
+| **Standalone** | `'standalone'` | HTTP POST to BLS `handlerUrl` | HTTP POST to `/admin/ilp/send` |
+
+When `deploymentMode` is omitted, it is inferred from `localDelivery` and `adminApi` flags.
+
+### Embedded Mode (Recommended for Libraries)
+
+Pass a `ConnectorConfig` object directly for programmatic usage:
+
+```typescript
+import { ConnectorNode } from '@toon-protocol/connector';
+import type { ConnectorConfig } from '@toon-protocol/connector';
+import pino from 'pino';
+
+const config: ConnectorConfig = {
+  nodeId: 'connector-a',
+  btpServerPort: 4000,
+  healthCheckPort: 8080,
+  deploymentMode: 'embedded',
+  adminApi: { enabled: false },
+  localDelivery: { enabled: false },
+  peers: [],
+  routes: [],
+  environment: 'production',
+};
+
+const node = new ConnectorNode(config, pino({ name: 'connector-a' }));
+
+node.setPacketHandler(async (request) => {
+  if (request.isTransit) {
+    // Transit notification (fire-and-forget at intermediate hops)
+    console.log(`Transit: ${request.amount} tokens → ${request.destination}`);
+    return { accept: true };
+  }
+  // Final-hop delivery
+  console.log(`Delivery: ${request.amount} tokens from ${request.sourcePeer}`);
+  return { accept: true };
+});
+
+await node.start();
+
+// Register peers dynamically at runtime
+await node.registerPeer({
+  id: 'connector-b',
+  url: 'ws://localhost:4001',
+  authToken: '',
+  routes: [{ prefix: 'g.connector-b' }],
+  evmAddress: '0xConnectorBAddress...', // peer's EVM settlement address
+});
+
+// Send a packet
+await node.sendPacket({
+  destination: 'g.connector-b.agent',
+  amount: 1000n,
+  executionCondition: Buffer.alloc(32),
+  expiresAt: new Date(Date.now() + 30000),
+  data: Buffer.from('Hello'),
+});
+```
+
+### Standalone Mode
+
+For separate-process deployments, configure `localDelivery` and `adminApi`:
+
+```yaml
+nodeId: my-connector
+btpServerPort: 3000
+healthCheckPort: 8080
+deploymentMode: standalone
+environment: production
+
+localDelivery:
+  enabled: true
+  handlerUrl: http://my-bls:3100
+  timeout: 5000
+
+adminApi:
+  enabled: true
+  port: 8081
+  apiKey: ${ADMIN_API_KEY}
+
+peers:
+  - id: peer-b
+    url: ws://peer-b:3001
+    authToken: ''
+```
+
+## ConnectorConfig Reference
+
+The constructor accepts either a YAML file path or a `ConnectorConfig` object:
+
+```typescript
+const node = new ConnectorNode(config: ConnectorConfig | string, logger: Logger);
+```
+
+### Required Fields
+
+| Field           | Type            | Description                                      |
+| --------------- | --------------- | ------------------------------------------------ |
+| `nodeId`        | `string`        | Unique identifier for this connector             |
+| `btpServerPort` | `number`        | Port for BTP WebSocket server                    |
+| `peers`         | `PeerConfig[]`  | Peer connector definitions                       |
+| `routes`        | `RouteConfig[]` | Routing table entries                            |
+| `environment`   | `Environment`   | `'development'` \| `'staging'` \| `'production'` |
+
+### Optional Fields
+
+| Field             | Type                    | Default       | Description                                    |
+| ----------------- | ----------------------- | ------------- | ---------------------------------------------- |
+| `deploymentMode`  | `DeploymentMode`        | inferred      | `'embedded'` \| `'standalone'`                 |
+| `healthCheckPort` | `number`                | `8080`        | HTTP health endpoint port                      |
+| `logLevel`        | `string`                | `'info'`      | `'debug'` \| `'info'` \| `'warn'` \| `'error'` |
+| `adminApi`        | `AdminApiConfig`        | disabled      | Admin REST API settings                        |
+| `localDelivery`   | `LocalDeliveryConfig`   | disabled      | HTTP forwarding to BLS                         |
+| `settlement`      | `SettlementConfig`      | —             | TigerBeetle accounting config                  |
+| `settlementInfra` | `SettlementInfraConfig` | —             | EVM settlement infrastructure                  |
+| `blockchain`      | `BlockchainConfig`      | —             | Multi-chain EVM config (Base, Arbitrum)        |
+| `security`        | `SecurityConfig`        | —             | Key management backend                         |
+| `performance`     | `PerformanceConfig`     | —             | Batching, pooling, parallelization             |
+| `explorer`        | `ExplorerConfig`        | enabled:3001  | Explorer UI settings                           |
+| `mode`            | `string`                | `'connector'` | `'connector'` \| `'gateway'`                   |
+
+### PeerConfig
+
+```typescript
+interface PeerConfig {
+  id: string; // Unique peer identifier (referenced by routes)
+  url: string; // WebSocket URL: ws://host:port or wss://host:port
+  authToken: string; // Shared secret (empty string for permissionless)
+  evmAddress?: string; // Peer's EVM address for settlement
+}
+```
+
+### RouteConfig
+
+```typescript
+interface RouteConfig {
+  prefix: string; // ILP address prefix (e.g., 'g.connector-b')
+  nextHop: string; // Peer ID to forward to
+  priority?: number; // Higher wins (default: 0)
+}
+```
+
+## ConnectorNode Public API
+
+### Lifecycle
+
+| Method    | Returns         | Description                                         |
+| --------- | --------------- | --------------------------------------------------- |
+| `start()` | `Promise<void>` | Start BTP server, connect to peers, init settlement |
+| `stop()`  | `Promise<void>` | Graceful shutdown of all connections and servers    |
+
+### Packet Handling
+
+| Method                             | Returns                                        | Description                            |
+| ---------------------------------- | ---------------------------------------------- | -------------------------------------- |
+| `setPacketHandler(handler)`        | `void`                                         | Register callback for incoming packets |
+| `setLocalDeliveryHandler(handler)` | `void`                                         | Register callback for local delivery   |
+| `sendPacket(params)`               | `Promise<ILPFulfillPacket \| ILPRejectPacket>` | Send ILP Prepare packet                |
+
+### Peer Management
+
+| Method                              | Returns                     | Description              |
+| ----------------------------------- | --------------------------- | ------------------------ |
+| `registerPeer(config)`              | `Promise<PeerInfo>`         | Add peer at runtime      |
+| `removePeer(peerId, removeRoutes?)` | `Promise<RemovePeerResult>` | Remove peer              |
+| `listPeers()`                       | `PeerInfo[]`                | List all connected peers |
+
+### Routing
+
+| Method                                 | Returns       | Description        |
+| -------------------------------------- | ------------- | ------------------ |
+| `listRoutes()`                         | `RouteInfo[]` | List routing table |
+| `addRoute(prefix, nextHop, priority?)` | —             | Add a route        |
+| `removeRoute(prefix)`                  | —             | Remove a route     |
+
+### Balance & Settlement
+
+| Method                        | Returns                       | Description               |
+| ----------------------------- | ----------------------------- | ------------------------- |
+| `getBalance(peerId)`          | `Promise<PeerAccountBalance>` | Query peer balances       |
+| `openChannel(peerId, amount)` | `Promise<void>`               | Open EVM payment channel  |
+| `getChannelState(peerId)`     | `Promise<...>`                | Get payment channel state |
+
+### Mode Inspection
+
+| Method                | Returns          | Description                            |
+| --------------------- | ---------------- | -------------------------------------- |
+| `getDeploymentMode()` | `DeploymentMode` | Returns `'embedded'` or `'standalone'` |
+| `isEmbedded()`        | `boolean`        | Check if embedded mode                 |
+| `isStandalone()`      | `boolean`        | Check if standalone mode               |
+
+## BTP Authentication
+
+### Permissionless Networks (Default)
+
+Default mode for open networks where security is at the ILP layer:
+
+```yaml
+peers:
+  - id: peer-b
+    url: ws://peer-b:3001
+    authToken: '' # Empty = permissionless
+```
+
+### Private Networks
+
+Disable permissionless mode and use shared secrets:
+
+```bash
+BTP_ALLOW_NOAUTH=false
+BTP_PEER_PEER_B_SECRET=secret-token
+```
+
+```yaml
+peers:
+  - id: peer-b
+    url: ws://peer-b:3001
+    authToken: secret-token
+```
+
+## Per-Hop Notification
+
+Intermediate connectors can fire non-blocking notifications to a BLS for transit packets:
+
+```yaml
+localDelivery:
+  enabled: true
+  handlerUrl: http://my-bls:3100
+  perHopNotification: true
+```
+
+|                  | Transit (`isTransit: true`) | Final-Hop (`isTransit` omitted)    |
+| ---------------- | --------------------------- | ---------------------------------- |
+| **When**         | Packet passing through      | Packet addressed to this connector |
+| **BLS response** | Ignored (fire-and-forget)   | Drives ILP fulfill/reject          |
+| **Blocking**     | No                          | Yes                                |
+| **Use case**     | Logging, analytics          | Payment acceptance, business logic |
+
+## Accounting Backend
+
+### Default: In-Memory Ledger
+
+Zero dependencies. Persists to JSON snapshots on disk.
+
+| Variable                     | Default                       | Description               |
+| ---------------------------- | ----------------------------- | ------------------------- |
+| `LEDGER_SNAPSHOT_PATH`       | `./data/ledger-snapshot.json` | Snapshot file path        |
+| `LEDGER_PERSIST_INTERVAL_MS` | `30000`                       | Persistence interval (ms) |
+
+### Optional: TigerBeetle
+
+High-performance double-entry accounting. Falls back to in-memory if connection fails.
+
+| Variable                 | Required | Description                       |
+| ------------------------ | -------- | --------------------------------- |
+| `TIGERBEETLE_CLUSTER_ID` | Yes      | TigerBeetle cluster identifier    |
+| `TIGERBEETLE_REPLICAS`   | Yes      | Comma-separated replica addresses |
+
+## Settlement Infrastructure
+
+EVM payment channels on Base L2 (and optionally Arbitrum):
+
+| Variable                      | Description                                                   |
+| ----------------------------- | ------------------------------------------------------------- |
+| `SETTLEMENT_ENABLED`          | Enable automatic settlement (default: `true`)                 |
+| `SETTLEMENT_THRESHOLD`        | Balance threshold to trigger settlement                       |
+| `SETTLEMENT_POLLING_INTERVAL` | Polling frequency in ms (default: `30000`)                    |
+| `BASE_L2_RPC_URL`             | Base L2 RPC endpoint                                          |
+| `EVM_PRIVATE_KEY`             | Private key (dev only — use KMS in production)                |
+| `M2M_TOKEN_ADDRESS`           | ERC-20 token contract                                         |
+| `TOKEN_NETWORK_REGISTRY`      | Payment channel registry contract                             |
+| `KEY_BACKEND`                 | Key management: `env` \| `aws-kms` \| `gcp-kms` \| `azure-kv` |
+| `NETWORK_MODE`                | Auto-configure chain settings: `testnet` \| `mainnet`         |
+
+### Multi-Chain Support
+
+Configure per-chain settings via `blockchain` config:
+
+```typescript
+const config: ConnectorConfig = {
+  // ...
+  blockchain: {
+    base: {
+      enabled: true,
+      rpcUrl: 'https://mainnet.base.org',
+      chainId: 8453,
+    },
+    arbitrum: {
+      enabled: true,
+      rpcUrl: 'https://arb1.arbitrum.io/rpc',
+      chainId: 42161,
+    },
+  },
+};
+```
+
+## Explorer UI
+
+Built-in real-time dashboard for packet flow, balances, and settlement monitoring.
+
+| Variable                  | Default   | Description              |
+| ------------------------- | --------- | ------------------------ |
+| `EXPLORER_ENABLED`        | `true`    | Enable/disable explorer  |
+| `EXPLORER_PORT`           | `3001`    | HTTP/WebSocket port      |
+| `EXPLORER_RETENTION_DAYS` | `7`       | Event retention period   |
+| `EXPLORER_MAX_EVENTS`     | `1000000` | Maximum events to retain |
+
+**Endpoints:**
+
+| Endpoint          | Description                                  |
+| ----------------- | -------------------------------------------- |
+| `GET /api/events` | Query historical events (supports filtering) |
+| `GET /api/health` | Explorer health status                       |
+| `WS /ws`          | Real-time event streaming                    |
+
+## Admin API
+
+REST endpoints for runtime peer/route management and ILP packet sending.
+
+| Endpoint                       | Description           |
+| ------------------------------ | --------------------- |
+| `GET /admin/peers`             | List all peers        |
+| `POST /admin/peers`            | Add a new peer        |
+| `DELETE /admin/peers/:peerId`  | Remove a peer         |
+| `GET /admin/routes`            | List routing table    |
+| `POST /admin/routes`           | Add a route           |
+| `DELETE /admin/routes/:prefix` | Remove a route        |
+| `POST /admin/ilp/send`         | Send ILP packet       |
+| `GET /admin/balances/:peerId`  | Query peer balances   |
+| `GET /admin/channels`          | List payment channels |
+| `POST /admin/channels`         | Open payment channel  |
+
+### Security
+
+| Variable                | Description                                              |
+| ----------------------- | -------------------------------------------------------- |
+| `ADMIN_API_KEY`         | API key (required in production unless IP allowlist set) |
+| `ADMIN_API_ALLOWED_IPS` | Comma-separated IPs/CIDRs                                |
+| `ADMIN_API_TRUST_PROXY` | Trust `X-Forwarded-For` (default: `false`)               |
+
+## CLI Commands
+
+```bash
+npx connector setup              # Interactive onboarding wizard
+npx connector start -c config.yaml  # Start connector
+npx connector health -u http://localhost:8080  # Check health
+npx connector validate config.yaml  # Validate config file
+```
+
+## Exported API
+
+**Classes:** `ConnectorNode`, `ConfigLoader`, `ConfigurationError`, `ConnectorNotStartedError`, `RoutingTable`, `PacketHandler`, `BTPServer`, `BTPClient`, `BTPClientManager`, `AdminServer`, `AccountManager`, `SettlementMonitor`, `UnifiedSettlementExecutor`, `IlpSendHandler`
+
+**Types:** `ConnectorConfig`, `PeerConfig`, `RouteConfig`, `SettlementConfig`, `SettlementInfraConfig`, `LocalDeliveryConfig`, `LocalDeliveryHandler`, `LocalDeliveryRequest`, `LocalDeliveryResponse`, `SendPacketParams`, `PeerRegistrationRequest`, `PeerInfo`, `PeerAccountBalance`, `RouteInfo`, `RemovePeerResult`, `IlpSendRequest`, `IlpSendResponse`, `AdminSettlementConfig`, `ChannelOpenOptions`, `ChannelMetadata`, `PaymentRequest`, `PaymentResponse`, `PaymentHandler`, `PacketSenderFn`, `IsReadyFn`, `ILPPreparePacket`, `ILPFulfillPacket`, `ILPRejectPacket`
+
+**Utilities:** `createLogger`, `createPaymentHandlerAdapter`, `computeFulfillmentFromData`, `computeConditionFromData`, `validateIlpSendRequest`, `generatePaymentId`, `mapRejectCode`, `validateResponseData`, `REJECT_CODE_MAP`
+
+## Package Structure
+
+```
+src/
+├── core/       # ConnectorNode, PacketHandler, payment handler, local delivery
+├── btp/        # BTP server and client (WebSocket peers)
+├── routing/    # Routing table and prefix matching
+├── settlement/ # EVM settlement, payment channels, account manager
+├── http/       # Admin API, health endpoints, ILP send handler
+├── explorer/   # Embedded telemetry UI server and event store
+├── wallet/     # HD wallet derivation for EVM keys
+├── security/   # KMS integration (AWS, Azure, GCP)
+├── config/     # Configuration schema, loader, and validation
+├── cli/        # CLI commands (setup, start, health, validate)
+└── utils/      # Logger, OER encoding
+```
+
+## Testing
+
+```bash
+npm test                 # Unit tests
+npm run test:acceptance  # Acceptance tests
+```
+
+## License
+
+MIT — see [LICENSE](../../LICENSE).

package/dist/btp/btp-claim-types.d.ts

@@ -0,0 +1,30 @@
+export type BlockchainType = 'evm';
+export interface BaseClaimMessage {
+    version: '1.0';
+    blockchain: BlockchainType;
+    messageId: string;
+    timestamp: string;
+    senderId: string;
+}
+export interface EVMClaimMessage extends BaseClaimMessage {
+    blockchain: 'evm';
+    channelId: string;
+    nonce: number;
+    transferredAmount: string;
+    lockedAmount: string;
+    locksRoot: string;
+    signature: string;
+    signerAddress: string;
+    chainId?: number;
+    tokenNetworkAddress?: string;
+    tokenAddress?: string;
+}
+export type BTPClaimMessage = EVMClaimMessage;
+export declare const BTP_CLAIM_PROTOCOL: {
+    readonly NAME: "payment-channel-claim";
+    readonly CONTENT_TYPE: 1;
+    readonly VERSION: "1.0";
+};
+export declare function isEVMClaim(msg: BTPClaimMessage): msg is EVMClaimMessage;
+export declare function validateClaimMessage(msg: unknown): asserts msg is BTPClaimMessage;
+//# sourceMappingURL=btp-claim-types.d.ts.map

package/dist/btp/btp-claim-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"btp-claim-types.d.ts","sourceRoot":"","sources":["../../src/btp/btp-claim-types.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC;AAYnC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0CD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,UAAU,EAAE,KAAK,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAU9C,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAaX,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,eAAe,CAEvE;AAwGD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,eAAe,CAwCjF"}

package/dist/btp/btp-claim-types.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BTP_CLAIM_PROTOCOL = void 0;
+exports.isEVMClaim = isEVMClaim;
+exports.validateClaimMessage = validateClaimMessage;
+exports.BTP_CLAIM_PROTOCOL = {
+    NAME: 'payment-channel-claim',
+    CONTENT_TYPE: 1,
+    VERSION: '1.0',
+};
+function isEVMClaim(msg) {
+    return msg.blockchain === 'evm';
+}
+function validateEVMClaim(claim) {
+    if (!claim.channelId || typeof claim.channelId !== 'string') {
+        throw new Error('Missing or invalid channelId (expected non-empty string)');
+    }
+    if (claim.nonce === undefined || typeof claim.nonce !== 'number' || claim.nonce < 0) {
+        throw new Error('Missing or invalid nonce (expected non-negative number)');
+    }
+    if (!claim.transferredAmount || typeof claim.transferredAmount !== 'string') {
+        throw new Error('Missing or invalid transferredAmount (expected non-empty string)');
+    }
+    if (!claim.lockedAmount || typeof claim.lockedAmount !== 'string') {
+        throw new Error('Missing or invalid lockedAmount (expected non-empty string)');
+    }
+    if (!claim.locksRoot || typeof claim.locksRoot !== 'string') {
+        throw new Error('Missing or invalid locksRoot (expected non-empty string)');
+    }
+    if (!claim.signature || typeof claim.signature !== 'string') {
+        throw new Error('Missing or invalid signature (expected non-empty string)');
+    }
+    if (!claim.signerAddress || typeof claim.signerAddress !== 'string') {
+        throw new Error('Missing or invalid signerAddress (expected non-empty string)');
+    }
+    if (!/^0x[0-9a-fA-F]{64}$/.test(claim.channelId)) {
+        throw new Error('Invalid channelId format (expected 0x-prefixed 64-char hex)');
+    }
+    if (!/^0x[0-9a-fA-F]{40}$/.test(claim.signerAddress)) {
+        throw new Error('Invalid signerAddress format (expected 0x-prefixed 40-char hex)');
+    }
+    if (!/^0x[0-9a-fA-F]{64}$/.test(claim.locksRoot)) {
+        throw new Error('Invalid locksRoot format (expected 0x-prefixed 64-char hex)');
+    }
+    if (!/^\d+$/.test(claim.transferredAmount)) {
+        throw new Error('Invalid transferredAmount (expected non-negative integer string)');
+    }
+    if (!/^\d+$/.test(claim.lockedAmount)) {
+        throw new Error('Invalid lockedAmount (expected non-negative integer string)');
+    }
+    if (claim.chainId !== undefined) {
+        if (typeof claim.chainId !== 'number' ||
+            !Number.isInteger(claim.chainId) ||
+            claim.chainId <= 0) {
+            throw new Error('Invalid chainId (expected positive integer)');
+        }
+    }
+    if (claim.tokenNetworkAddress !== undefined) {
+        if (typeof claim.tokenNetworkAddress !== 'string') {
+            throw new Error('Invalid tokenNetworkAddress (expected string)');
+        }
+        if (!/^0x[0-9a-fA-F]{40}$/.test(claim.tokenNetworkAddress)) {
+            throw new Error('Invalid tokenNetworkAddress format (expected 0x-prefixed 40-char hex)');
+        }
+    }
+    if (claim.tokenAddress !== undefined) {
+        if (typeof claim.tokenAddress !== 'string') {
+            throw new Error('Invalid tokenAddress (expected string)');
+        }
+        if (!/^0x[0-9a-fA-F]{40}$/.test(claim.tokenAddress)) {
+            throw new Error('Invalid tokenAddress format (expected 0x-prefixed 40-char hex)');
+        }
+    }
+}
+function validateClaimMessage(msg) {
+    if (typeof msg !== 'object' || msg === null) {
+        throw new Error('Claim message must be an object');
+    }
+    const claim = msg;
+    if (claim.version !== '1.0') {
+        throw new Error(`Invalid version (expected '1.0', got '${claim.version}')`);
+    }
+    if (!claim.blockchain) {
+        throw new Error('Missing blockchain field');
+    }
+    if (claim.blockchain !== 'evm') {
+        throw new Error(`Unsupported blockchain type: ${claim.blockchain}`);
+    }
+    if (!claim.messageId || typeof claim.messageId !== 'string') {
+        throw new Error('Missing or invalid messageId (expected non-empty string)');
+    }
+    if (!claim.timestamp || typeof claim.timestamp !== 'string') {
+        throw new Error('Missing or invalid timestamp (expected ISO 8601 string)');
+    }
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/.test(claim.timestamp)) {
+        throw new Error('Invalid timestamp format (expected ISO 8601 with Z timezone)');
+    }
+    if (!claim.senderId || typeof claim.senderId !== 'string') {
+        throw new Error('Missing or invalid senderId (expected non-empty string)');
+    }
+    validateEVMClaim(claim);
+}
+//# sourceMappingURL=btp-claim-types.js.map

package/dist/btp/btp-claim-types.js.map

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

package/dist/btp/btp-client-manager.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from '../utils/logger';
+import { BTPClient, Peer } from './btp-client';
+import { ILPPreparePacket, ILPFulfillPacket, ILPRejectPacket } from '@toon-protocol/shared';
+import type { PacketHandler } from '../core/packet-handler';
+export declare class BTPClientManager {
+    private readonly _clients;
+    private readonly _logger;
+    private readonly _nodeId;
+    private _packetHandler;
+    constructor(nodeId: string, logger: Logger);
+    setPacketHandler(packetHandler: PacketHandler): void;
+    addPeer(peer: Peer): Promise<void>;
+    removePeer(peerId: string): Promise<void>;
+    sendToPeer(peerId: string, packet: ILPPreparePacket, protocolData?: Array<{
+        protocolName: string;
+        contentType: number;
+        data: Buffer;
+    }>): Promise<ILPFulfillPacket | ILPRejectPacket>;
+    getPeerStatus(): Map<string, boolean>;
+    getPeerIds(): string[];
+    getClientForPeer(peerId: string): BTPClient | undefined;
+    isConnected(peerId: string): boolean;
+    getConnectedPeerCount(): number;
+    getTotalPeerCount(): number;
+    getConnectionHealth(): number;
+}
+//# sourceMappingURL=btp-client-manager.d.ts.map

package/dist/btp/btp-client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"btp-client-manager.d.ts","sourceRoot":"","sources":["../../src/btp/btp-client-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAsB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,cAAc,CAA8B;gBAOxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAS1C,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAa9C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAwElC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCzC,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAChF,OAAO,CAAC,gBAAgB,GAAG,eAAe,CAAC;IAiE9C,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAYrC,UAAU,IAAI,MAAM,EAAE;IAUtB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAUvD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUpC,qBAAqB,IAAI,MAAM;IAU/B,iBAAiB,IAAI,MAAM;IAS3B,mBAAmB,IAAI,MAAM;CAQ9B"}