@ryanrfox/sdk 0.0.2 → 2.0.3

package/README.md

@@ -1,45 +1,161 @@
-# @ryanrfox/sdk
+# Radius TypeScript SDK
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+[![Version](https://img.shields.io/badge/version-2.0.0--alpha.7-blue)](package.json)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../LICENSE)
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+The official TypeScript SDK for [Radius](https://radiustech.xyz/). Built on [viem](https://viem.sh/) for seamless EVM compatibility.
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+> **V2 Alpha Notice:** This SDK is in pre-release and not yet published to npm. You must build and link locally to use it.
 
-## Purpose
+> **ESM Only:** This SDK is published as ES Modules only. CommonJS (`require()`) is not supported. Your project must use `"type": "module"` in package.json or use `.mjs` extensions.
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@ryanrfox/sdk`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+## Local Installation
 
-## What is OIDC Trusted Publishing?
+V2 is not yet on npm. Build and link locally:
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+```bash
+# In this directory (typescript/)
+pnpm install
+pnpm build
+pnpm link --global
+```
 
-## Setup Instructions
+Then in your project:
 
-To properly configure OIDC trusted publishing for this package:
+```bash
+pnpm link --global @radiustechsystems/sdk
+# Or: npm link @radiustechsystems/sdk
+```
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+When done testing:
 
-## DO NOT USE THIS PACKAGE
+```bash
+pnpm unlink --global @radiustechsystems/sdk
+```
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+## Quick Start
 
-## More Information
+```typescript
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { radiusTestnet, radiusWalletActions } from '@radiustechsystems/sdk';
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+// Public client for reading blockchain state
+const publicClient = createPublicClient({
+  chain: radiusTestnet,
+  transport: http(),
+});
 
----
+// Wallet client for sending transactions
+const walletClient = createWalletClient({
+  account: privateKeyToAccount('0x...'),
+  chain: radiusTestnet,
+  transport: http(),
+}).extend(radiusWalletActions());
 
-**Maintained for OIDC setup purposes only**
+// Check balance (standard viem API)
+const balance = await publicClient.getBalance({
+  address: walletClient.account.address,
+});
+
+// Send transaction (standard viem API)
+const hash = await walletClient.sendTransaction({
+  to: '0x...recipient',
+  value: 1000000000000000000n,
+});
+
+// Wait for receipt
+const receipt = await publicClient.waitForTransactionReceipt({ hash });
+```
+
+## Batch Transactions
+
+Radius doesn't queue future-nonce transactions like Ethereum. Use `sendTransactionBatch` to send multiple transactions atomically:
+
+```typescript
+const hashes = await walletClient.sendTransactionBatch({
+  transactions: [
+    { to: '0x...', value: 1000000000000000000n },
+    { to: '0x...', data: '0x...' },
+  ],
+});
+```
+
+## SDK Architecture
+
+The SDK follows viem's decorator pattern:
+
+```
+@radiustechsystems/sdk/
+├── chains/            # Chain definitions (radius, radiusTestnet)
+├── decorators/        # Client extension decorators (radiusWalletActions)
+├── actions/           # Standalone action functions
+├── contracts/         # Typed contract utilities
+├── errors/            # Typed error classes
+├── events/            # Event watching utilities
+└── transport/         # Transport utilities
+```
+
+## Extending Viem Clients
+
+```typescript
+import { createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { radiusTestnet, radiusWalletActions } from '@radiustechsystems/sdk';
+
+const client = createWalletClient({
+  account: privateKeyToAccount('0x...'),
+  chain: radiusTestnet,
+  transport: http(),
+}).extend(radiusWalletActions());
+
+// Now has sendTransactionBatch available
+const hashes = await client.sendTransactionBatch({
+  transactions: [{ to: '0x...', value: 1n }],
+});
+```
+
+## Features
+
+- **Chain Configs** — Pre-configured chains for Radius mainnet and testnet
+- **Batch Transactions** — Send multiple transactions atomically
+- **Events** — Watch blocks, transfers, approvals, and logs
+- **Multicall3** — Batch contract reads (configured on testnet)
+
+## Subpath Exports
+
+```typescript
+import { radiusTestnet, radiusWalletActions, MAX_GAS } from '@radiustechsystems/sdk';
+import { radius, radiusTestnet } from '@radiustechsystems/sdk/chains';
+import { decodeEventLogs, filterEventLogs } from '@radiustechsystems/sdk/events';
+```
+
+## Documentation
+
+**[docs.radiustech.xyz](https://docs.radiustech.xyz/)** — Full documentation, guides, and API reference.
+
+- [Getting Started](https://docs.radiustech.xyz/getting-started)
+- [TypeScript SDK Guide](https://docs.radiustech.xyz/sdk/typescript)
+- [API Reference](https://docs.radiustech.xyz/sdk/typescript/api)
+
+## Requirements
+
+- Node.js >= 22
+- ESM project (`"type": "module"` in package.json)
+- pnpm (for local development)
+- [Testnet Access](https://docs.radiustech.xyz/radius-testnet-access)
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `RADIUS_RPC_URL` | RPC endpoint URL |
+| `RADIUS_PRIVATE_KEY` | Account private key (for scripts) |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](../LICENSE)

package/package.json

@@ -1,10 +1,86 @@
 {
-  "name": "@ryanrfox/sdk",
-  "version": "0.0.2",
-  "description": "OIDC trusted publishing setup package for @ryanrfox/sdk",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+	"name": "@ryanrfox/sdk",
+	"version": "2.0.3",
+	"description": "TypeScript SDK for interacting with the Radius Platform",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ryanRfox/sdk.git"
+	},
+	"type": "module",
+	"scripts": {
+		"build": "pnpm clean && pnpm build:esm && pnpm build:types",
+		"build:esm": "tsc --project ./tsconfig.build.json --module esnext --moduleResolution bundler --outDir ./src/_esm && printf '{\"type\": \"module\",\"sideEffects\":false}' > ./src/_esm/package.json",
+		"build:types": "tsc --project ./tsconfig.build.json --module esnext --moduleResolution bundler --declarationDir ./src/_types --emitDeclarationOnly --declaration --declarationMap",
+		"check": "biome check . --fix --unsafe",
+		"check:types": "tsc --noEmit",
+		"clean": "rimraf src/_types src/_esm ./tsconfig.build.tsbuildinfo src/tsconfig.build.tsbuildinfo",
+		"format": "biome format --write",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"test": "vitest --run",
+		"test:watch": "vitest",
+		"generate:api": "typedoc",
+		"generate:guides": "npx tsx scripts/generate-guides.ts",
+		"generate:docs": "pnpm generate:api && pnpm generate:guides",
+		"docs:check": "npx tsx scripts/validate-docs.ts",
+		"prepublishOnly": "pnpm run check && pnpm run test && pnpm run build"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.2.2",
+		"@types/node": "^22.10.0",
+		"@vitest/coverage-v8": "^4.0.15",
+		"rimraf": "^6.0.1",
+		"typedoc": "0.28.16",
+		"typedoc-plugin-markdown": "4.9.0",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.15"
+	},
+	"peerDependencies": {
+		"typescript": ">=5.0.0",
+		"viem": ">=2.0.0"
+	},
+	"engines": {
+		"node": ">=24"
+	},
+	"license": "MIT",
+	"packageManager": "pnpm@9.14.2",
+	"main": "./src/_esm/index.js",
+	"module": "./src/_esm/index.js",
+	"types": "./src/_types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./src/_types/index.d.ts",
+			"import": "./src/_esm/index.js",
+			"default": "./src/_esm/index.js"
+		},
+		"./chains": {
+			"types": "./src/_types/chains/index.d.ts",
+			"import": "./src/_esm/chains/index.js",
+			"default": "./src/_esm/chains/index.js"
+		},
+		"./events": {
+			"types": "./src/_types/events/index.d.ts",
+			"import": "./src/_esm/events/index.js",
+			"default": "./src/_esm/events/index.js"
+		}
+	},
+	"files": [
+		"src/_esm",
+		"src/_types"
+	],
+	"keywords": [
+		"radius",
+		"evm",
+		"viem",
+		"sdk",
+		"ethereum",
+		"crypto"
+	],
+	"homepage": "https://github.com/ryanRfox/sdk/tree/main/typescript#readme",
+	"bugs": {
+		"url": "https://github.com/ryanRfox/sdk/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
 }

package/src/_esm/actions/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Radius SDK Actions
+ *
+ * Standalone action functions that can be used with viem clients.
+ * These follow viem's action pattern and are composed into decorators.
+ */
+export { type SendTransactionBatchParameters, type SendTransactionBatchReturnType, sendTransactionBatch, } from './sendTransactionBatch.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_esm/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../actions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,oBAAoB,GACpB,MAAM,2BAA2B,CAAC"}

package/src/_esm/actions/index.js

@@ -0,0 +1,8 @@
+/**
+ * Radius SDK Actions
+ *
+ * Standalone action functions that can be used with viem clients.
+ * These follow viem's action pattern and are composed into decorators.
+ */
+export { sendTransactionBatch, } from './sendTransactionBatch.js';
+//# sourceMappingURL=index.js.map

package/src/_esm/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../actions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGN,oBAAoB,GACpB,MAAM,2BAA2B,CAAC"}

package/src/_esm/actions/sendTransactionBatch.d.ts

@@ -0,0 +1,77 @@
+/**
+ * sendTransactionBatch action - sends multiple transactions in a single JSON-RPC batch request.
+ *
+ * Radius does not queue future-nonce transactions like Ethereum. This action ensures
+ * all transactions arrive in nonce order by using JSON-RPC batching.
+ */
+import type { Account, Address, Chain, Client, Hash, Hex, Transport } from 'viem';
+/** Default maximum number of transactions in a single batch */
+export declare const DEFAULT_MAX_BATCH_SIZE = 100;
+/** Default timeout for batch fetch requests in milliseconds (30 seconds) */
+export declare const DEFAULT_BATCH_TIMEOUT = 30000;
+/**
+ * Transaction request for batch submission.
+ */
+export interface SendTransactionBatchParameters {
+    /** Array of transactions to send in the batch */
+    transactions: Array<{
+        /** The recipient address */
+        to: Address;
+        /** The amount to send in wei (default: 0n) */
+        value?: bigint;
+        /** The transaction data (for contract calls) */
+        data?: Hex;
+        /** Gas limit (if not provided, will be estimated) */
+        gas?: bigint;
+    }>;
+    /** Maximum number of transactions allowed in the batch (default: 100) */
+    maxBatchSize?: number;
+    /** Timeout in milliseconds for the batch fetch request (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Return type for sendTransactionBatch action.
+ */
+export type SendTransactionBatchReturnType = Hash[];
+/**
+ * Send multiple transactions in a single JSON-RPC batch request.
+ * Transactions are automatically assigned sequential nonces and sent atomically.
+ *
+ * @param client - The viem client (must have an account attached)
+ * @param params - The batch transaction parameters
+ * @param params.transactions - Array of transaction objects to send
+ * @param params.maxBatchSize - Maximum batch size (default: 100)
+ * @param params.timeout - Fetch timeout in milliseconds (default: 30000)
+ * @returns Array of transaction hashes in the same order as input
+ * @throws {BatchTransactionError} If any transaction in the batch fails
+ * @throws {GasEstimationError} If gas estimation fails for any transaction
+ * @throws {RadiusError} If input validation fails, HTTP request fails, or request times out
+ *
+ * @remarks
+ * **Transport Note:** This function uses a direct `fetch()` call rather than
+ * the client's configured transport. Custom transport interceptors, retry logic,
+ * or middleware will not be applied to batch requests. This is necessary because
+ * viem's transport layer does not expose batch JSON-RPC capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { createWalletClient, http } from 'viem';
+ * import { privateKeyToAccount } from 'viem/accounts';
+ * import { radiusTestnet, radiusWalletActions } from '@radiustechsystems/sdk';
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: radiusTestnet,
+ *   transport: http(),
+ * }).extend(radiusWalletActions());
+ *
+ * const hashes = await client.sendTransactionBatch({
+ *   transactions: [
+ *     { to: '0x...', value: 1000000000000000000n },
+ *     { to: '0x...', data: '0x...' },
+ *   ],
+ * });
+ * ```
+ */
+export declare function sendTransactionBatch<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, params: SendTransactionBatchParameters): Promise<SendTransactionBatchReturnType>;
+//# sourceMappingURL=sendTransactionBatch.d.ts.map

package/src/_esm/actions/sendTransactionBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendTransactionBatch.d.ts","sourceRoot":"","sources":["../../actions/sendTransactionBatch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AASlF,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C,iDAAiD;IACjD,YAAY,EAAE,KAAK,CAAC;QACnB,4BAA4B;QAC5B,EAAE,EAAE,OAAO,CAAC;QACZ,8CAA8C;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gDAAgD;QAChD,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,qDAAqD;QACrD,GAAG,CAAC,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,EAAE,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,oBAAoB,CACzC,KAAK,SAAS,KAAK,GAAG,SAAS,EAC/B,OAAO,SAAS,OAAO,GAAG,SAAS,EAEnC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,EACzC,MAAM,EAAE,8BAA8B,GACpC,OAAO,CAAC,8BAA8B,CAAC,CAgNzC"}

package/src/_esm/actions/sendTransactionBatch.js

@@ -0,0 +1,245 @@
+import { MAX_GAS } from '../chains/chainConfig.js';
+import { BatchTransactionError, GasEstimationError, RadiusError, } from '../errors/index.js';
+/** Default maximum number of transactions in a single batch */
+export const DEFAULT_MAX_BATCH_SIZE = 100;
+/** Default timeout for batch fetch requests in milliseconds (30 seconds) */
+export const DEFAULT_BATCH_TIMEOUT = 30000;
+/**
+ * Send multiple transactions in a single JSON-RPC batch request.
+ * Transactions are automatically assigned sequential nonces and sent atomically.
+ *
+ * @param client - The viem client (must have an account attached)
+ * @param params - The batch transaction parameters
+ * @param params.transactions - Array of transaction objects to send
+ * @param params.maxBatchSize - Maximum batch size (default: 100)
+ * @param params.timeout - Fetch timeout in milliseconds (default: 30000)
+ * @returns Array of transaction hashes in the same order as input
+ * @throws {BatchTransactionError} If any transaction in the batch fails
+ * @throws {GasEstimationError} If gas estimation fails for any transaction
+ * @throws {RadiusError} If input validation fails, HTTP request fails, or request times out
+ *
+ * @remarks
+ * **Transport Note:** This function uses a direct `fetch()` call rather than
+ * the client's configured transport. Custom transport interceptors, retry logic,
+ * or middleware will not be applied to batch requests. This is necessary because
+ * viem's transport layer does not expose batch JSON-RPC capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { createWalletClient, http } from 'viem';
+ * import { privateKeyToAccount } from 'viem/accounts';
+ * import { radiusTestnet, radiusWalletActions } from '@radiustechsystems/sdk';
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: radiusTestnet,
+ *   transport: http(),
+ * }).extend(radiusWalletActions());
+ *
+ * const hashes = await client.sendTransactionBatch({
+ *   transactions: [
+ *     { to: '0x...', value: 1000000000000000000n },
+ *     { to: '0x...', data: '0x...' },
+ *   ],
+ * });
+ * ```
+ */
+export async function sendTransactionBatch(client, params) {
+    const { transactions, maxBatchSize = DEFAULT_MAX_BATCH_SIZE, timeout = DEFAULT_BATCH_TIMEOUT, } = params;
+    // Validate input
+    if (!Array.isArray(transactions)) {
+        throw new RadiusError('sendTransactionBatch expects an array of transactions', {
+            metaMessages: [
+                'Example: client.sendTransactionBatch({ transactions: [{ to: "0x...", value: 1n }] })',
+            ],
+            details: `Received: ${typeof transactions}`,
+        });
+    }
+    if (transactions.length === 0) {
+        throw new RadiusError('sendTransactionBatch requires at least one transaction', {
+            metaMessages: ['Pass an array with at least one transaction request.'],
+        });
+    }
+    if (transactions.length > maxBatchSize) {
+        throw new RadiusError(`Batch size ${transactions.length} exceeds maximum allowed size of ${maxBatchSize}`, {
+            metaMessages: [
+                `Split your transactions into smaller batches of ${maxBatchSize} or fewer.`,
+                'You can also increase the limit by passing maxBatchSize option.',
+            ],
+            details: `Received ${transactions.length} transactions, max is ${maxBatchSize}`,
+        });
+    }
+    // Ensure we have an account
+    const account = client.account;
+    if (!account) {
+        throw new RadiusError('sendTransactionBatch requires an account', {
+            metaMessages: [
+                'Create a wallet client with an account:',
+                'createWalletClient({ account: privateKeyToAccount("0x..."), ... })',
+            ],
+        });
+    }
+    // Get the chain ID
+    const chainId = client.chain?.id;
+    if (!chainId) {
+        throw new RadiusError('sendTransactionBatch requires a chain', {
+            metaMessages: ['Create a wallet client with a chain: createWalletClient({ chain, ... })'],
+        });
+    }
+    // Get RPC URL from transport
+    const rpcUrl = getRpcUrl(client);
+    // Get current nonce once
+    const startNonce = await client.request({
+        method: 'eth_getTransactionCount',
+        params: [account.address, 'pending'],
+    });
+    const nonce = Number(startNonce);
+    // Estimate gas for each transaction (in parallel for efficiency)
+    const gasEstimates = await Promise.all(transactions.map(async (tx, i) => {
+        if (tx.gas !== undefined) {
+            return tx.gas;
+        }
+        try {
+            const estimate = await client.request({
+                method: 'eth_estimateGas',
+                params: [
+                    {
+                        from: account.address,
+                        to: tx.to,
+                        data: tx.data,
+                        value: tx.value ? `0x${tx.value.toString(16)}` : undefined,
+                    },
+                ],
+            });
+            // Apply 20% safety margin
+            const estimatedGas = BigInt(estimate);
+            const margin = estimatedGas / 5n;
+            let gas = estimatedGas + margin;
+            // Cap at MAX_GAS
+            if (gas > MAX_GAS) {
+                gas = MAX_GAS;
+            }
+            return gas;
+        }
+        catch (error) {
+            throw new GasEstimationError(`Gas estimation failed for transaction at index ${i}`, {
+                to: tx.to,
+                data: tx.data,
+                cause: error instanceof Error ? error : undefined,
+                metaMessages: [
+                    'The transaction may revert on-chain.',
+                    'Check that the recipient address is valid and the contract call is correct.',
+                ],
+            });
+        }
+    }));
+    // Ensure the account has signTransaction
+    if (!account.signTransaction) {
+        throw new RadiusError('Account does not support signTransaction', {
+            metaMessages: ['Use an account that supports signing, like privateKeyToAccount()'],
+        });
+    }
+    // Sign all transactions with sequential nonces
+    const signedTxs = await Promise.all(transactions.map(async (tx, i) => {
+        // Use the account's signTransaction method
+        const signedTx = await account.signTransaction?.({
+            to: tx.to,
+            data: tx.data,
+            value: tx.value ?? 0n,
+            nonce: nonce + i,
+            gas: gasEstimates[i],
+            gasPrice: 0n, // Radius uses zero gas price
+            chainId,
+        });
+        return signedTx;
+    }));
+    // Build JSON-RPC batch request
+    const batchRequest = signedTxs.map((raw, i) => ({
+        jsonrpc: '2.0',
+        id: i,
+        method: 'eth_sendRawTransaction',
+        params: [raw],
+    }));
+    // Send single HTTP POST request with timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    let response;
+    try {
+        response = await fetch(rpcUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(batchRequest),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new RadiusError(`Batch request timed out after ${timeout}ms`, {
+                metaMessages: [
+                    'The RPC endpoint did not respond in time.',
+                    'You can increase the timeout by passing the timeout option.',
+                ],
+                details: `Timeout: ${timeout}ms`,
+            });
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    if (!response.ok) {
+        throw new RadiusError(`Batch request failed with status ${response.status}`, {
+            details: await response.text(),
+        });
+    }
+    const batchResponse = (await response.json());
+    // Parse responses and match by id to preserve order
+    const results = [];
+    const hashes = [];
+    let hasError = false;
+    // Sort responses by id to ensure order matches input
+    const sortedResponses = [...batchResponse].sort((a, b) => a.id - b.id);
+    for (let i = 0; i < transactions.length; i++) {
+        const res = sortedResponses[i];
+        if (res?.result) {
+            results.push({ index: i, hash: res.result });
+            hashes.push(res.result);
+        }
+        else {
+            const errorMsg = res?.error?.data || res?.error?.message || 'Unknown error';
+            results.push({ index: i, error: errorMsg });
+            hasError = true;
+        }
+    }
+    // If any transaction failed, throw with details
+    if (hasError) {
+        const failedCount = results.filter((r) => r.error).length;
+        throw new BatchTransactionError(`${failedCount} of ${transactions.length} transactions failed`, results);
+    }
+    return hashes;
+}
+/**
+ * Extract RPC URL from client transport.
+ */
+function getRpcUrl(client) {
+    // Try to get URL from chain config first
+    const chainUrl = client.chain?.rpcUrls?.default?.http?.[0];
+    if (chainUrl) {
+        return chainUrl;
+    }
+    // Check environment variables (Node.js only)
+    if (typeof process !== 'undefined' && process.env) {
+        const envUrl = process.env.RADIUS_RPC_URL || process.env.RADIUS_ENDPOINT;
+        if (envUrl) {
+            return envUrl;
+        }
+    }
+    throw new RadiusError('Unable to determine RPC URL', {
+        metaMessages: [
+            'Ensure your client has a chain configured with rpcUrls',
+            'Or set RADIUS_RPC_URL environment variable',
+        ],
+    });
+}
+//# sourceMappingURL=sendTransactionBatch.js.map

package/src/_esm/actions/sendTransactionBatch.js.map

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