@shroud-fi/transport 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShroudFi 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,55 @@
+# @shroud-fi/transport
+
+> Pluggable viem-based transport + canonical Base mainnet deployment manifest.
+
+[![npm](https://img.shields.io/npm/v/@shroud-fi/transport.svg)](https://www.npmjs.com/package/@shroud-fi/transport)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+```bash
+npm i @shroud-fi/transport viem
+```
+
+## What it does
+
+`@shroud-fi/transport` is the I/O layer for the ShroudFi SDK. It wraps [viem](https://viem.sh/) clients for RPC reads, contract calls, and event subscription — and ships the canonical Base mainnet deployment manifest (`ShroudFiStealth`, `ShroudFiRegistrar`, relayer addresses, deploy block heights).
+
+You can swap your own RPC URL or a private mempool transport in without touching the rest of the SDK.
+
+## Quick start
+
+```ts
+import { createTransport, getDeployment } from '@shroud-fi/transport';
+import { base } from 'viem/chains';
+
+const transport = createTransport({
+  chain: base,
+  rpcUrl: process.env.BASE_RPC_URL!,
+});
+
+const deployment = getDeployment(8453);
+console.log(deployment.shroudfiStealth);
+// → 0x4BC88813b09dDD6Ab530261200D706B397EcD0AB
+```
+
+## Exports
+
+| Symbol | Purpose |
+|---|---|
+| `createTransport(cfg)` | Build a transport from `chain`, `rpcUrl`, or an existing viem client. |
+| `getDeployment(chainId)` | Lookup verified contract addresses + deploy blocks by chain ID. Base mainnet = `8453`. |
+| `ShroudFiStealthAbi` · `RegistrarAbi` · `RelayerAbi` · `EthRelayerAbi` | Typed ABIs for every deployed contract. |
+| `DeploymentManifest` | Type for the manifest. |
+
+Full API reference: [shroudfi.live/sdk#transport](https://shroudfi.live/sdk#transport)
+
+## Supported chains
+
+- **Base mainnet** (8453) — production, contracts verified on Blockscout.
+
+Other chains can be added by extending the manifest at deploy time; the SDK is chain-agnostic by design.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+Part of the [ShroudFi](https://shroudfi.live) privacy SDK for AI agents on Base.

package/dist/cjs/abis.d.ts

@@ -0,0 +1,446 @@
+export declare const ERC5564AnnouncerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "announce";
+    readonly inputs: readonly [{
+        readonly name: "schemeId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "stealthAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "ephemeralPubKey";
+        readonly type: "bytes";
+    }, {
+        readonly name: "metadata";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "Announcement";
+    readonly inputs: readonly [{
+        readonly name: "schemeId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "stealthAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "caller";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "ephemeralPubKey";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadata";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }];
+}];
+export declare const ShroudFiStealthAbi: readonly [{
+    readonly type: "function";
+    readonly name: "sendETH";
+    readonly inputs: readonly [{
+        readonly name: "stealthAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "ephemeralPubKey";
+        readonly type: "bytes";
+    }, {
+        readonly name: "viewTag";
+        readonly type: "bytes1";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "sendERC20";
+    readonly inputs: readonly [{
+        readonly name: "stealthAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ephemeralPubKey";
+        readonly type: "bytes";
+    }, {
+        readonly name: "viewTag";
+        readonly type: "bytes1";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "ANNOUNCER";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "SCHEME_ID";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "ETH_TOKEN_ADDRESS";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "StealthPayment";
+    readonly inputs: readonly [{
+        readonly name: "stealthAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientETH";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ETHTransferFailed";
+    readonly inputs: readonly [];
+}];
+/**
+ * Minimal ABI for USDC's EIP-3009 `transferWithAuthorization`. Pulled out as
+ * a separate constant because not every ERC-20 supports it — only Circle's
+ * USDC contract and a handful of other authorization-capable tokens. Use
+ * `USDC_BY_CHAIN[chainId]` to address the right deployment.
+ *
+ * The `authorizationState` view is included so callers can confirm a nonce
+ * has not already been consumed before submitting.
+ */
+export declare const USDCAuthorizationAbi: readonly [{
+    readonly type: "function";
+    readonly name: "transferWithAuthorization";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validBefore";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "authorizationState";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "AuthorizationUsed";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}];
+export declare const ERC20Abi: readonly [{
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];
+export declare const ShroudFiRelayerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "sweepERC20WithPermit";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "destination";
+        readonly type: "address";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "previewFee";
+    readonly inputs: readonly [{
+        readonly name: "grossAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "fee";
+        readonly type: "uint256";
+    }, {
+        readonly name: "net";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "FEE_BPS";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint16";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "BPS_DENOMINATOR";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint16";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "TREASURY";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "treasury";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "trustedForwarder";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isTrustedForwarder";
+    readonly inputs: readonly [{
+        readonly name: "forwarder";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "SweepRelayed";
+    readonly inputs: readonly [{
+        readonly name: "stealthAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "destination";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "grossAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "feeAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidToken";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidDestination";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroBalance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PermitFailedAndNoAllowance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TransferFailed";
+    readonly inputs: readonly [];
+}];
+export declare const ERC6538RegistryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "registerKeys";
+    readonly inputs: readonly [{
+        readonly name: "schemeId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "stealthMetaAddress";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "stealthMetaAddressOf";
+    readonly inputs: readonly [{
+        readonly name: "registrant";
+        readonly type: "address";
+    }, {
+        readonly name: "schemeId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "incrementNonce";
+    readonly inputs: readonly [{
+        readonly name: "schemeId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+//# sourceMappingURL=abis.d.ts.map

package/dist/cjs/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../../src/abis.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBtB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DrB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCvB,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCX,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmFrB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BrB,CAAC"}