@chipi-stack/core 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Chipi Pay
+
+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,91 @@
+# @chipi-stack/core
+
+Core primitives for Chipi Pay SDK: transaction building, token math, signer adapters, and fee estimation.
+
+## Install
+
+```bash
+npm install @chipi-stack/core
+```
+
+## Modules
+
+### TxBuilder
+
+Build Starknet multicall transactions with a fluent API:
+
+```typescript
+import { TxBuilder } from "@chipi-stack/core";
+
+const tx = TxBuilder.new()
+  .transfer({ token: "USDC", to: "0x...", amount: "10.00" })
+  .approve({ token: "USDC", spender: "0x...", amount: "50.00" })
+  .build();
+```
+
+### TokenRegistry
+
+Look up token metadata (address, decimals) by symbol and network:
+
+```typescript
+import { TokenRegistry } from "@chipi-stack/core";
+
+const usdc = TokenRegistry.get("USDC", "mainnet");
+// { address: "0x033068...", decimals: 6, symbol: "USDC" }
+```
+
+### Amount
+
+Safe token amount math with decimal precision:
+
+```typescript
+import { Amount } from "@chipi-stack/core";
+
+const amt = Amount.fromHuman("10.50", 6); // 10.5 USDC
+amt.toRaw();   // 10500000n
+amt.toHuman(); // "10.50"
+```
+
+### Signers
+
+Unified `SignerAdapter` interface with three implementations:
+
+```typescript
+import { DirectSigner, ExternalSigner, PasskeySigner } from "@chipi-stack/core";
+
+// Local key (testing only)
+const direct = new DirectSigner("0x...");
+
+// External provider (Privy, Cartridge, etc.)
+const external = new ExternalSigner({
+  getPublicKey: () => provider.getPublicKey(),
+  sign: (hash) => provider.sign(hash),
+  getAccountAddress: () => provider.getAddress(),
+});
+
+// Passkey-based signer
+const passkey = new PasskeySigner({
+  authenticateFn: (challenge) => passkeyAuth(challenge),
+  publicKey: "0x...",
+  accountAddress: "0x...",
+});
+```
+
+### Fee Estimation
+
+Estimate Starknet transaction fees before execution:
+
+```typescript
+import { estimateFee, preflight } from "@chipi-stack/core";
+
+const fee = await estimateFee(calls, account);
+const check = await preflight(calls, account); // fee + balance check
+```
+
+## Documentation
+
+Full docs at [docs.chipipay.com](https://docs.chipipay.com)
+
+## License
+
+MIT

package/dist/estimation/estimate-fee.d.ts

@@ -0,0 +1,21 @@
+import type { Account, Call } from "starknet";
+import type { FeeEstimate, PreflightResult } from "./types.js";
+/**
+ * Estimate invocation fees for a set of calls.
+ * Does NOT execute the transaction.
+ *
+ * @param calls - Array of Starknet calls to estimate
+ * @param account - Starknet Account instance
+ * @throws If calls array is empty
+ */
+export declare function estimateFee(calls: Call[], account: Account): Promise<FeeEstimate>;
+/**
+ * Simulate a transaction without submitting it.
+ * Returns trace and fee estimation.
+ *
+ * @param calls - Array of Starknet calls to simulate
+ * @param account - Starknet Account instance
+ * @throws If calls array is empty
+ */
+export declare function preflight(calls: Call[], account: Account): Promise<PreflightResult>;
+//# sourceMappingURL=estimate-fee.d.ts.map

package/dist/estimation/estimate-fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-fee.d.ts","sourceRoot":"","sources":["../../src/estimation/estimate-fee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAIvF;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CASzF"}

package/dist/estimation/estimate-fee.js

@@ -0,0 +1,34 @@
+/**
+ * Estimate invocation fees for a set of calls.
+ * Does NOT execute the transaction.
+ *
+ * @param calls - Array of Starknet calls to estimate
+ * @param account - Starknet Account instance
+ * @throws If calls array is empty
+ */
+export async function estimateFee(calls, account) {
+    if (calls.length === 0)
+        throw new Error("No calls to estimate");
+    const result = await account.estimateInvokeFee(calls);
+    return result;
+}
+/**
+ * Simulate a transaction without submitting it.
+ * Returns trace and fee estimation.
+ *
+ * @param calls - Array of Starknet calls to simulate
+ * @param account - Starknet Account instance
+ * @throws If calls array is empty
+ */
+export async function preflight(calls, account) {
+    if (calls.length === 0)
+        throw new Error("No calls to preflight");
+    const result = await account.simulateTransaction([{ type: "INVOKE", payload: calls }], {
+        skipValidate: false,
+    });
+    if (!result || result.length === 0) {
+        throw new Error("Simulation returned no results");
+    }
+    return result[0];
+}
+//# sourceMappingURL=estimate-fee.js.map

package/dist/estimation/estimate-fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-fee.js","sourceRoot":"","sources":["../../src/estimation/estimate-fee.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAa,EAAE,OAAgB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,MAAgC,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,OAAgB;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;QAC9F,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAA+B,CAAC;AACjD,CAAC"}

package/dist/estimation/types.d.ts

@@ -0,0 +1,14 @@
+export interface FeeEstimate {
+    overall_fee: bigint;
+    gas_consumed: bigint;
+    gas_price: bigint;
+    data_gas_consumed?: bigint;
+    data_gas_price?: bigint;
+}
+export interface PreflightResult {
+    transaction_trace: unknown;
+    fee_estimation: {
+        overall_fee: bigint;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/estimation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/estimation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC"}

package/dist/estimation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/estimation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/estimation/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { Amount, type TokenInfo } from "./tokens/amount.js";
+export { Erc20 } from "./tokens/erc20.js";
+export { TokenRegistry, type Network } from "./tokens/registry.js";
+export { TxBuilder } from "./transactions/tx-builder.js";
+export type { TransferTarget, PreflightResult } from "./transactions/types.js";
+export { DirectSigner } from "./signers/direct-signer.js";
+export { PasskeySigner } from "./signers/passkey-signer.js";
+export { ExternalSigner } from "./signers/external-signer.js";
+export type { SignerAdapter, SignResult } from "./signers/types.js";
+export { estimateFee, preflight } from "./estimation/estimate-fee.js";
+export type { FeeEstimate } from "./estimation/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Tokens
+export { Amount } from "./tokens/amount.js";
+export { Erc20 } from "./tokens/erc20.js";
+export { TokenRegistry } from "./tokens/registry.js";
+// Transactions
+export { TxBuilder } from "./transactions/tx-builder.js";
+// Signers
+export { DirectSigner } from "./signers/direct-signer.js";
+export { PasskeySigner } from "./signers/passkey-signer.js";
+export { ExternalSigner } from "./signers/external-signer.js";
+// Estimation
+export { estimateFee, preflight } from "./estimation/estimate-fee.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,MAAM,EAAkB,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AAEnE,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/signers/direct-signer.d.ts

@@ -0,0 +1,18 @@
+import type { SignerAdapter, SignResult } from "./types.js";
+/**
+ * Signer backed by a local private key.
+ * Equivalent to StarkZap's StarkSigner.
+ *
+ * WARNING: Only for development/testing.
+ * Never hardcode private keys in production.
+ */
+export declare class DirectSigner implements SignerAdapter {
+    private readonly privateKey;
+    private readonly publicKey;
+    private readonly accountAddress;
+    constructor(privateKey: string, accountAddress?: string);
+    getPublicKey(): Promise<string>;
+    sign(messageHash: string): Promise<SignResult>;
+    getAccountAddress(): Promise<string>;
+}
+//# sourceMappingURL=direct-signer.d.ts.map

package/dist/signers/direct-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-signer.d.ts","sourceRoot":"","sources":["../../src/signers/direct-signer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAWjD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ9C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAG3C"}

package/dist/signers/direct-signer.js

@@ -0,0 +1,32 @@
+import { ec, encode } from "starknet";
+/**
+ * Signer backed by a local private key.
+ * Equivalent to StarkZap's StarkSigner.
+ *
+ * WARNING: Only for development/testing.
+ * Never hardcode private keys in production.
+ */
+export class DirectSigner {
+    constructor(privateKey, accountAddress) {
+        if (!privateKey || !/^0x[0-9a-fA-F]+$/.test(privateKey)) {
+            throw new Error("Invalid private key: must be a hex string starting with 0x");
+        }
+        this.privateKey = privateKey;
+        this.publicKey = encode.addHexPrefix(encode.buf2hex(ec.starkCurve.getPublicKey(privateKey, true)));
+        this.accountAddress = accountAddress ?? this.publicKey;
+    }
+    async getPublicKey() {
+        return this.publicKey;
+    }
+    async sign(messageHash) {
+        const signature = ec.starkCurve.sign(messageHash, this.privateKey);
+        return {
+            r: encode.addHexPrefix(signature.r.toString(16)),
+            s: encode.addHexPrefix(signature.s.toString(16)),
+        };
+    }
+    async getAccountAddress() {
+        return this.accountAddress;
+    }
+}
+//# sourceMappingURL=direct-signer.js.map

package/dist/signers/direct-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-signer.js","sourceRoot":"","sources":["../../src/signers/direct-signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAKvB,YAAY,UAAkB,EAAE,cAAuB;QACrD,IAAI,CAAC,UAAU,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,CAClC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAC7D,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,OAAO;YACL,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/signers/external-signer.d.ts

@@ -0,0 +1,17 @@
+import type { SignerAdapter, SignResult } from "./types.js";
+/**
+ * Adapter for external signer providers (Privy, Cartridge, etc.).
+ * Consumers provide the signing function — ExternalSigner just wraps the interface.
+ */
+export declare class ExternalSigner implements SignerAdapter {
+    private readonly opts;
+    constructor(opts: {
+        getPublicKey: () => Promise<string>;
+        sign: (messageHash: string) => Promise<SignResult>;
+        getAccountAddress: () => Promise<string>;
+    });
+    getPublicKey(): Promise<string>;
+    sign(messageHash: string): Promise<SignResult>;
+    getAccountAddress(): Promise<string>;
+}
+//# sourceMappingURL=external-signer.d.ts.map

package/dist/signers/external-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-signer.d.ts","sourceRoot":"","sources":["../../src/signers/external-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;GAGG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAInB;gBAEU,IAAI,EAAE;QAChB,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;QACnD,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;KAC1C;IAID,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAG/B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAG9C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAGrC"}

package/dist/signers/external-signer.js

@@ -0,0 +1,19 @@
+/**
+ * Adapter for external signer providers (Privy, Cartridge, etc.).
+ * Consumers provide the signing function — ExternalSigner just wraps the interface.
+ */
+export class ExternalSigner {
+    constructor(opts) {
+        this.opts = opts;
+    }
+    getPublicKey() {
+        return this.opts.getPublicKey();
+    }
+    sign(messageHash) {
+        return this.opts.sign(messageHash);
+    }
+    getAccountAddress() {
+        return this.opts.getAccountAddress();
+    }
+}
+//# sourceMappingURL=external-signer.js.map

package/dist/signers/external-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-signer.js","sourceRoot":"","sources":["../../src/signers/external-signer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAOzB,YAAY,IAIX;QACC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,WAAmB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IACD,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACvC,CAAC;CACF"}

package/dist/signers/passkey-signer.d.ts

@@ -0,0 +1,25 @@
+import type { SignerAdapter, SignResult } from "./types.js";
+/**
+ * Signer that wraps @chipi-stack/passkey functions.
+ * Does NOT modify @chipi-stack/passkey — only wraps it.
+ *
+ * @param authenticateFn - The authenticatePasskey function from @chipi-stack/passkey
+ * @param publicKey - The passkey public key (obtained during registration)
+ */
+export declare class PasskeySigner implements SignerAdapter {
+    private readonly authenticateFn;
+    private readonly pubKey;
+    private readonly accountAddress;
+    constructor(opts: {
+        authenticateFn: (challenge: string) => Promise<{
+            r: string;
+            s: string;
+        }>;
+        publicKey: string;
+        accountAddress: string;
+    });
+    getPublicKey(): Promise<string>;
+    sign(messageHash: string): Promise<SignResult>;
+    getAccountAddress(): Promise<string>;
+}
+//# sourceMappingURL=passkey-signer.d.ts.map

package/dist/signers/passkey-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkey-signer.d.ts","sourceRoot":"","sources":["../../src/signers/passkey-signer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2D;IAC1F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,IAAI,EAAE;QAChB,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACzE,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB;IAMK,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAG3C"}

package/dist/signers/passkey-signer.js

@@ -0,0 +1,24 @@
+/**
+ * Signer that wraps @chipi-stack/passkey functions.
+ * Does NOT modify @chipi-stack/passkey — only wraps it.
+ *
+ * @param authenticateFn - The authenticatePasskey function from @chipi-stack/passkey
+ * @param publicKey - The passkey public key (obtained during registration)
+ */
+export class PasskeySigner {
+    constructor(opts) {
+        this.authenticateFn = opts.authenticateFn;
+        this.pubKey = opts.publicKey;
+        this.accountAddress = opts.accountAddress;
+    }
+    async getPublicKey() {
+        return this.pubKey;
+    }
+    async sign(messageHash) {
+        return this.authenticateFn(messageHash);
+    }
+    async getAccountAddress() {
+        return this.accountAddress;
+    }
+}
+//# sourceMappingURL=passkey-signer.js.map

package/dist/signers/passkey-signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkey-signer.js","sourceRoot":"","sources":["../../src/signers/passkey-signer.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAKxB,YAAY,IAIX;QACC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/signers/types.d.ts

@@ -0,0 +1,19 @@
+/** Result of a signing operation. */
+export interface SignResult {
+    r: string;
+    s: string;
+}
+/**
+ * Unified signer interface.
+ * Implementations wrap different key management strategies
+ * (local key, passkey, external provider).
+ */
+export interface SignerAdapter {
+    /** Get the public key associated with this signer. */
+    getPublicKey(): Promise<string>;
+    /** Sign a message hash. */
+    sign(messageHash: string): Promise<SignResult>;
+    /** Get the account address derived from this signer. */
+    getAccountAddress(): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/signers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signers/types.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/C,wDAAwD;IACxD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC"}

package/dist/signers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/signers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signers/types.ts"],"names":[],"mappings":""}

package/dist/tokens/amount.d.ts

@@ -0,0 +1,72 @@
+/** Minimal token info needed by Amount. */
+export interface TokenInfo {
+    symbol: string;
+    decimals: number;
+    address: string;
+}
+/**
+ * Immutable representation of a token amount.
+ * Stores raw base units (e.g., wei for ETH, micro-units for USDC).
+ * All arithmetic is exact BigInt math — no floating point.
+ */
+export declare class Amount {
+    /** Raw value in base units (smallest denomination). */
+    readonly raw: bigint;
+    /** Number of decimal places for this token. */
+    readonly decimals: number;
+    /** Token symbol (e.g., "USDC", "ETH"). */
+    readonly symbol: string;
+    private constructor();
+    private static assertValidDecimals;
+    /**
+     * Parse a human-readable string into an Amount.
+     * @param value - Human-readable value (e.g., "1.5")
+     * @param token - Token info with decimals and symbol
+     * @throws If value is negative, non-numeric, or has too many decimal places
+     */
+    static parse(value: string, token: TokenInfo): Amount;
+    /**
+     * Create an Amount from a raw bigint value (base units).
+     * @param raw - Raw value in base units
+     * @param decimals - Token decimal places
+     * @param symbol - Token symbol (defaults to "")
+     */
+    static fromRaw(raw: bigint, decimals: number, symbol?: string): Amount;
+    /** Add two amounts. Both must have the same decimals. */
+    add(other: Amount): Amount;
+    /**
+     * Subtract an amount.
+     * @throws If result would be negative
+     */
+    subtract(other: Amount): Amount;
+    /**
+     * Multiply by a scalar bigint.
+     * @throws If scalar is negative
+     */
+    multiply(scalar: bigint): Amount;
+    /**
+     * Divide by a scalar bigint. Truncates (no rounding).
+     * @throws If divisor is zero or negative
+     */
+    divide(divisor: bigint): Amount;
+    eq(other: Amount): boolean;
+    gt(other: Amount): boolean;
+    gte(other: Amount): boolean;
+    lt(other: Amount): boolean;
+    lte(other: Amount): boolean;
+    isZero(): boolean;
+    /** Returns the raw bigint value (base units). */
+    toBase(): bigint;
+    /**
+     * Returns human-readable string (e.g., "1.5").
+     * Trailing zeros after decimal are preserved to one place minimum.
+     */
+    toUnit(): string;
+    /**
+     * Returns formatted string with symbol (e.g., "1.5 USDC").
+     * @param compressed - If true, shorten large numbers (e.g., "1.5M USDC")
+     */
+    toFormatted(compressed?: boolean): string;
+    private assertSameDecimals;
+}
+//# sourceMappingURL=amount.d.ts.map

package/dist/tokens/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../src/tokens/amount.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,MAAM;IACjB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO;IAMP,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAkBrD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM;IAQlE,yDAAyD;IACzD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKhC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQ/B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI1B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,MAAM,IAAI,OAAO;IAMjB,iDAAiD;IACjD,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAYhB;;;OAGG;IACH,WAAW,CAAC,UAAU,UAAQ,GAAG,MAAM;IAwBvC,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/tokens/amount.js

@@ -0,0 +1,166 @@
+/**
+ * Immutable representation of a token amount.
+ * Stores raw base units (e.g., wei for ETH, micro-units for USDC).
+ * All arithmetic is exact BigInt math — no floating point.
+ */
+export class Amount {
+    constructor(raw, decimals, symbol) {
+        this.raw = raw;
+        this.decimals = decimals;
+        this.symbol = symbol;
+    }
+    static assertValidDecimals(decimals) {
+        if (!Number.isInteger(decimals) || decimals < 0) {
+            throw new Error("Token decimals must be a non-negative integer");
+        }
+    }
+    // ── Factory Methods ──────────────────────────────────────────
+    /**
+     * Parse a human-readable string into an Amount.
+     * @param value - Human-readable value (e.g., "1.5")
+     * @param token - Token info with decimals and symbol
+     * @throws If value is negative, non-numeric, or has too many decimal places
+     */
+    static parse(value, token) {
+        Amount.assertValidDecimals(token.decimals);
+        if (!/^\d+(\.\d+)?$/.test(value)) {
+            throw new Error(`Invalid amount: "${value}" — must be a non-negative number`);
+        }
+        const [whole, fraction = ""] = value.split(".");
+        if (fraction.length > token.decimals) {
+            throw new Error(`Too many decimal places: ${fraction.length} > ${token.decimals} for ${token.symbol}`);
+        }
+        const padded = fraction.padEnd(token.decimals, "0");
+        const raw = BigInt(whole + padded);
+        return new Amount(raw, token.decimals, token.symbol);
+    }
+    /**
+     * Create an Amount from a raw bigint value (base units).
+     * @param raw - Raw value in base units
+     * @param decimals - Token decimal places
+     * @param symbol - Token symbol (defaults to "")
+     */
+    static fromRaw(raw, decimals, symbol = "") {
+        if (raw < 0n)
+            throw new Error("Amount cannot be negative");
+        Amount.assertValidDecimals(decimals);
+        return new Amount(raw, decimals, symbol);
+    }
+    // ── Arithmetic ───────────────────────────────────────────────
+    /** Add two amounts. Both must have the same decimals. */
+    add(other) {
+        this.assertSameDecimals(other);
+        return new Amount(this.raw + other.raw, this.decimals, this.symbol);
+    }
+    /**
+     * Subtract an amount.
+     * @throws If result would be negative
+     */
+    subtract(other) {
+        this.assertSameDecimals(other);
+        if (this.raw < other.raw) {
+            throw new Error("Subtraction would result in negative amount");
+        }
+        return new Amount(this.raw - other.raw, this.decimals, this.symbol);
+    }
+    /**
+     * Multiply by a scalar bigint.
+     * @throws If scalar is negative
+     */
+    multiply(scalar) {
+        if (scalar < 0n)
+            throw new Error("Scalar cannot be negative");
+        return new Amount(this.raw * scalar, this.decimals, this.symbol);
+    }
+    /**
+     * Divide by a scalar bigint. Truncates (no rounding).
+     * @throws If divisor is zero or negative
+     */
+    divide(divisor) {
+        if (divisor === 0n)
+            throw new Error("Division by zero");
+        if (divisor < 0n)
+            throw new Error("Divisor cannot be negative");
+        return new Amount(this.raw / divisor, this.decimals, this.symbol);
+    }
+    // ── Comparisons ──────────────────────────────────────────────
+    eq(other) {
+        this.assertSameDecimals(other);
+        return this.raw === other.raw;
+    }
+    gt(other) {
+        this.assertSameDecimals(other);
+        return this.raw > other.raw;
+    }
+    gte(other) {
+        this.assertSameDecimals(other);
+        return this.raw >= other.raw;
+    }
+    lt(other) {
+        this.assertSameDecimals(other);
+        return this.raw < other.raw;
+    }
+    lte(other) {
+        this.assertSameDecimals(other);
+        return this.raw <= other.raw;
+    }
+    isZero() {
+        return this.raw === 0n;
+    }
+    // ── Formatting ───────────────────────────────────────────────
+    /** Returns the raw bigint value (base units). */
+    toBase() {
+        return this.raw;
+    }
+    /**
+     * Returns human-readable string (e.g., "1.5").
+     * Trailing zeros after decimal are preserved to one place minimum.
+     */
+    toUnit() {
+        const str = this.raw.toString().padStart(this.decimals + 1, "0");
+        const whole = str.slice(0, str.length - this.decimals) || "0";
+        const fraction = str.slice(str.length - this.decimals);
+        if (this.decimals === 0)
+            return whole;
+        // Trim trailing zeros but keep at least one decimal place
+        const trimmed = fraction.replace(/0+$/, "") || "0";
+        return `${whole}.${trimmed}`;
+    }
+    /**
+     * Returns formatted string with symbol (e.g., "1.5 USDC").
+     * @param compressed - If true, shorten large numbers (e.g., "1.5M USDC")
+     */
+    toFormatted(compressed = false) {
+        if (compressed) {
+            // Use BigInt arithmetic to avoid parseFloat precision loss
+            const scale = 10n ** BigInt(this.decimals);
+            const wholePart = this.raw / scale;
+            let display;
+            if (wholePart >= 1000000n) {
+                const major = wholePart / 1000000n;
+                const minor = (wholePart % 1000000n) / 100000n; // one decimal
+                display = `${major}.${minor}M`;
+            }
+            else if (wholePart >= 1000n) {
+                const major = wholePart / 1000n;
+                const minor = (wholePart % 1000n) / 100n; // one decimal
+                display = `${major}.${minor}K`;
+            }
+            else {
+                display = this.toUnit();
+            }
+            return this.symbol ? `${display} ${this.symbol}` : display;
+        }
+        return this.symbol ? `${this.toUnit()} ${this.symbol}` : this.toUnit();
+    }
+    // ── Internal ─────────────────────────────────────────────────
+    assertSameDecimals(other) {
+        if (this.decimals !== other.decimals) {
+            throw new Error(`Cannot operate on amounts with different decimals: ${this.decimals} vs ${other.decimals}`);
+        }
+        if (this.symbol && other.symbol && this.symbol !== other.symbol) {
+            throw new Error(`Cannot operate on amounts with different symbols: ${this.symbol} vs ${other.symbol}`);
+        }
+    }
+}
+//# sourceMappingURL=amount.js.map

package/dist/tokens/amount.js.map

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

package/dist/tokens/erc20.d.ts

@@ -0,0 +1,38 @@
+import type { Account, Call } from "starknet";
+import { Amount, type TokenInfo } from "./amount.js";
+/**
+ * Typed ERC20 contract wrapper.
+ * Generates Call objects for approve/transfer and queries for balance/allowance.
+ *
+ * @example
+ * const usdc = new Erc20({ symbol: 'USDC', decimals: 6, address: '0x...' }, account);
+ * const balance = await usdc.balanceOf(myAddress);
+ * console.log(balance.toFormatted()); // "150.5 USDC"
+ */
+export declare class Erc20 {
+    private readonly token;
+    private readonly account;
+    constructor(token: TokenInfo, account: Account);
+    /**
+     * Query the balance of an address.
+     * @returns Amount representing the balance
+     */
+    balanceOf(address: string): Promise<Amount>;
+    /**
+     * Query the allowance of owner for spender.
+     * @returns Amount representing the allowance
+     */
+    allowance(owner: string, spender: string): Promise<Amount>;
+    /**
+     * Build an approve Call (does not execute).
+     * @returns Call object for use with TxBuilder or Account.execute()
+     */
+    approveCall(spender: string, amount: Amount): Call;
+    /**
+     * Build a transfer Call (does not execute).
+     * @returns Call object for use with TxBuilder or Account.execute()
+     */
+    transferCall(recipient: string, amount: Amount): Call;
+    private assertCompatibleAmount;
+}
+//# sourceMappingURL=erc20.d.ts.map

package/dist/tokens/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/tokens/erc20.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;IAK9C;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjD;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhE;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUlD;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUrD,OAAO,CAAC,sBAAsB;CAY/B"}

package/dist/tokens/erc20.js

@@ -0,0 +1,79 @@
+import { uint256 } from "starknet";
+import { Amount } from "./amount.js";
+/**
+ * Typed ERC20 contract wrapper.
+ * Generates Call objects for approve/transfer and queries for balance/allowance.
+ *
+ * @example
+ * const usdc = new Erc20({ symbol: 'USDC', decimals: 6, address: '0x...' }, account);
+ * const balance = await usdc.balanceOf(myAddress);
+ * console.log(balance.toFormatted()); // "150.5 USDC"
+ */
+export class Erc20 {
+    constructor(token, account) {
+        this.token = token;
+        this.account = account;
+    }
+    /**
+     * Query the balance of an address.
+     * @returns Amount representing the balance
+     */
+    async balanceOf(address) {
+        const result = await this.account.callContract({
+            contractAddress: this.token.address,
+            entrypoint: "balanceOf",
+            calldata: [address],
+        });
+        // StarkNet returns uint256 as [low, high]
+        const raw = uint256.uint256ToBN({ low: result[0], high: result[1] });
+        return Amount.fromRaw(raw, this.token.decimals, this.token.symbol);
+    }
+    /**
+     * Query the allowance of owner for spender.
+     * @returns Amount representing the allowance
+     */
+    async allowance(owner, spender) {
+        const result = await this.account.callContract({
+            contractAddress: this.token.address,
+            entrypoint: "allowance",
+            calldata: [owner, spender],
+        });
+        const raw = uint256.uint256ToBN({ low: result[0], high: result[1] });
+        return Amount.fromRaw(raw, this.token.decimals, this.token.symbol);
+    }
+    /**
+     * Build an approve Call (does not execute).
+     * @returns Call object for use with TxBuilder or Account.execute()
+     */
+    approveCall(spender, amount) {
+        this.assertCompatibleAmount(amount);
+        const u256 = uint256.bnToUint256(amount.toBase());
+        return {
+            contractAddress: this.token.address,
+            entrypoint: "approve",
+            calldata: [spender, u256.low.toString(), u256.high.toString()],
+        };
+    }
+    /**
+     * Build a transfer Call (does not execute).
+     * @returns Call object for use with TxBuilder or Account.execute()
+     */
+    transferCall(recipient, amount) {
+        this.assertCompatibleAmount(amount);
+        const u256 = uint256.bnToUint256(amount.toBase());
+        return {
+            contractAddress: this.token.address,
+            entrypoint: "transfer",
+            calldata: [recipient, u256.low.toString(), u256.high.toString()],
+        };
+    }
+    assertCompatibleAmount(amount) {
+        if (amount.decimals !== this.token.decimals) {
+            throw new Error(`Amount decimals mismatch: expected ${this.token.decimals}, got ${amount.decimals}`);
+        }
+        if (amount.symbol && amount.symbol !== this.token.symbol) {
+            throw new Error(`Amount symbol mismatch: expected ${this.token.symbol}, got ${amount.symbol}`);
+        }
+    }
+}
+//# sourceMappingURL=erc20.js.map

package/dist/tokens/erc20.js.map

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

package/dist/tokens/presets/mainnet.json

@@ -0,0 +1,38 @@
+[
+    {
+        "symbol": "ETH",
+        "decimals": 18,
+        "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+        "name": "Ether"
+    },
+    {
+        "symbol": "USDC",
+        "decimals": 6,
+        "address": "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb",
+        "name": "USD Coin"
+    },
+    {
+        "symbol": "USDT",
+        "decimals": 6,
+        "address": "0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
+        "name": "Tether USD"
+    },
+    {
+        "symbol": "DAI",
+        "decimals": 18,
+        "address": "0x00da114221cb83fa859dbdb4c44beeaa0bb37c7537ad5ae66fe5e0efd20e6eb3",
+        "name": "Dai Stablecoin"
+    },
+    {
+        "symbol": "STRK",
+        "decimals": 18,
+        "address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
+        "name": "Starknet Token"
+    },
+    {
+        "symbol": "WBTC",
+        "decimals": 8,
+        "address": "0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac",
+        "name": "Wrapped Bitcoin"
+    }
+]

package/dist/tokens/presets/sepolia.json

@@ -0,0 +1,20 @@
+[
+    {
+        "symbol": "ETH",
+        "decimals": 18,
+        "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+        "name": "Ether"
+    },
+    {
+        "symbol": "USDC",
+        "decimals": 6,
+        "address": "0x005a643907b9a4bc6a55e9069c4fd5fd1f5c79a22470690f75556c4736e34426",
+        "name": "USD Coin (Testnet)"
+    },
+    {
+        "symbol": "STRK",
+        "decimals": 18,
+        "address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
+        "name": "Starknet Token"
+    }
+]

package/dist/tokens/registry.d.ts

@@ -0,0 +1,27 @@
+import type { TokenInfo } from "./amount.js";
+export type Network = "mainnet" | "sepolia";
+interface TokenEntry extends TokenInfo {
+    name: string;
+}
+/**
+ * Registry for looking up token metadata by symbol or address.
+ *
+ * @example
+ * const registry = new TokenRegistry('mainnet');
+ * const usdc = registry.bySymbol('USDC');
+ * const amount = Amount.parse('10.0', usdc!);
+ */
+export declare class TokenRegistry {
+    private readonly tokens;
+    private readonly bySymbolMap;
+    private readonly byAddressMap;
+    constructor(network: Network);
+    /** Find a token by its symbol (case-insensitive). */
+    bySymbol(symbol: string): TokenEntry | undefined;
+    /** Find a token by its contract address (case-insensitive). */
+    byAddress(address: string): TokenEntry | undefined;
+    /** List all tokens in this registry. */
+    all(): TokenEntry[];
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/tokens/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tokens/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5C,UAAU,UAAW,SAAQ,SAAS;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;gBAE3C,OAAO,EAAE,OAAO;IAU5B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIhD,+DAA+D;IAC/D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD,wCAAwC;IACxC,GAAG,IAAI,UAAU,EAAE;CAGpB"}

package/dist/tokens/registry.js

@@ -0,0 +1,38 @@
+import mainnetTokens from "./presets/mainnet.json" with { type: "json" };
+import sepoliaTokens from "./presets/sepolia.json" with { type: "json" };
+const PRESETS = {
+    mainnet: mainnetTokens,
+    sepolia: sepoliaTokens,
+};
+/**
+ * Registry for looking up token metadata by symbol or address.
+ *
+ * @example
+ * const registry = new TokenRegistry('mainnet');
+ * const usdc = registry.bySymbol('USDC');
+ * const amount = Amount.parse('10.0', usdc!);
+ */
+export class TokenRegistry {
+    constructor(network) {
+        const preset = PRESETS[network];
+        if (!preset) {
+            throw new Error(`Invalid network: "${network}". Must be "mainnet" or "sepolia".`);
+        }
+        this.tokens = preset;
+        this.bySymbolMap = new Map(preset.map((t) => [t.symbol.toUpperCase(), t]));
+        this.byAddressMap = new Map(preset.map((t) => [t.address.toLowerCase(), t]));
+    }
+    /** Find a token by its symbol (case-insensitive). */
+    bySymbol(symbol) {
+        return this.bySymbolMap.get(symbol.toUpperCase());
+    }
+    /** Find a token by its contract address (case-insensitive). */
+    byAddress(address) {
+        return this.byAddressMap.get(address.toLowerCase());
+    }
+    /** List all tokens in this registry. */
+    all() {
+        return [...this.tokens];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tokens/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tokens/registry.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzE,OAAO,aAAa,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAQzE,MAAM,OAAO,GAAkC;IAC7C,OAAO,EAAE,aAA6B;IACtC,OAAO,EAAE,aAA6B;CACvC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAKxB,YAAY,OAAgB;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,oCAAoC,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,qDAAqD;IACrD,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,+DAA+D;IAC/D,SAAS,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,wCAAwC;IACxC,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/transactions/tx-builder.d.ts

@@ -0,0 +1,56 @@
+import type { Account, Call, InvokeFunctionResponse, EstimateFeeResponseOverhead } from "starknet";
+import type { TransferTarget, PreflightResult } from "./types.js";
+/**
+ * Fluent builder for batching Starknet calls.
+ * All calls execute atomically via Account.execute().
+ *
+ * @example
+ * const result = await new TxBuilder(account)
+ *   .approve(tokenAddr, spenderAddr, amount)
+ *   .transfer(tokenAddr, [{ to: recipient, amount: 1000n }])
+ *   .send();
+ */
+export declare class TxBuilder {
+    private readonly account;
+    private readonly _calls;
+    private sent;
+    constructor(account: Account);
+    /** Returns a copy of the current call batch. */
+    calls(): Call[];
+    /**
+     * Add one or more raw calls.
+     * @param call - A single Call or array of Calls
+     */
+    add(call: Call | Call[]): this;
+    /**
+     * Add an ERC20 approve call.
+     * @param token - Token contract address
+     * @param spender - Address to approve
+     * @param amount - Raw amount in base units
+     */
+    approve(token: string, spender: string, amount: bigint): this;
+    /**
+     * Add one or more ERC20 transfer calls.
+     * @param token - Token contract address
+     * @param targets - Array of { to, amount } pairs
+     */
+    transfer(token: string, targets: TransferTarget[]): this;
+    /**
+     * Execute all batched calls atomically.
+     * @throws If no calls have been added
+     * @throws If send() was already called
+     */
+    send(): Promise<InvokeFunctionResponse>;
+    /**
+     * Estimate fees for the current batch without executing.
+     * @throws If no calls have been added
+     */
+    estimateFee(): Promise<EstimateFeeResponseOverhead>;
+    /**
+     * Simulate the transaction without submitting to the network.
+     * Useful for checking if a transaction would succeed.
+     * @throws If no calls have been added
+     */
+    preflight(): Promise<PreflightResult>;
+}
+//# sourceMappingURL=tx-builder.d.ts.map

package/dist/transactions/tx-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-builder.d.ts","sourceRoot":"","sources":["../../src/transactions/tx-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAEnG,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,OAAO;IAI5B,gDAAgD;IAChD,KAAK,IAAI,IAAI,EAAE;IAIf;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI;IAM9B;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAW7D;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAaxD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAQ7C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAKzD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;CAW5C"}

package/dist/transactions/tx-builder.js

@@ -0,0 +1,104 @@
+import { uint256 } from "starknet";
+/**
+ * Fluent builder for batching Starknet calls.
+ * All calls execute atomically via Account.execute().
+ *
+ * @example
+ * const result = await new TxBuilder(account)
+ *   .approve(tokenAddr, spenderAddr, amount)
+ *   .transfer(tokenAddr, [{ to: recipient, amount: 1000n }])
+ *   .send();
+ */
+export class TxBuilder {
+    constructor(account) {
+        this._calls = [];
+        this.sent = false;
+        this.account = account;
+    }
+    /** Returns a copy of the current call batch. */
+    calls() {
+        return [...this._calls];
+    }
+    /**
+     * Add one or more raw calls.
+     * @param call - A single Call or array of Calls
+     */
+    add(call) {
+        const toAdd = Array.isArray(call) ? call : [call];
+        this._calls.push(...toAdd);
+        return this;
+    }
+    /**
+     * Add an ERC20 approve call.
+     * @param token - Token contract address
+     * @param spender - Address to approve
+     * @param amount - Raw amount in base units
+     */
+    approve(token, spender, amount) {
+        if (amount < 0n)
+            throw new RangeError("Approve amount cannot be negative");
+        const u256 = uint256.bnToUint256(amount);
+        this._calls.push({
+            contractAddress: token,
+            entrypoint: "approve",
+            calldata: [spender, u256.low.toString(), u256.high.toString()],
+        });
+        return this;
+    }
+    /**
+     * Add one or more ERC20 transfer calls.
+     * @param token - Token contract address
+     * @param targets - Array of { to, amount } pairs
+     */
+    transfer(token, targets) {
+        for (const { to, amount } of targets) {
+            if (amount < 0n)
+                throw new RangeError("Transfer amount cannot be negative");
+            const u256 = uint256.bnToUint256(amount);
+            this._calls.push({
+                contractAddress: token,
+                entrypoint: "transfer",
+                calldata: [to, u256.low.toString(), u256.high.toString()],
+            });
+        }
+        return this;
+    }
+    /**
+     * Execute all batched calls atomically.
+     * @throws If no calls have been added
+     * @throws If send() was already called
+     */
+    async send() {
+        if (this.sent)
+            throw new Error("TxBuilder already sent — create a new builder");
+        if (this._calls.length === 0)
+            throw new Error("No calls to execute");
+        this.sent = true;
+        const calls = [...this._calls];
+        return this.account.execute(calls);
+    }
+    /**
+     * Estimate fees for the current batch without executing.
+     * @throws If no calls have been added
+     */
+    async estimateFee() {
+        if (this._calls.length === 0)
+            throw new Error("No calls to estimate");
+        return this.account.estimateInvokeFee([...this._calls]);
+    }
+    /**
+     * Simulate the transaction without submitting to the network.
+     * Useful for checking if a transaction would succeed.
+     * @throws If no calls have been added
+     */
+    async preflight() {
+        if (this._calls.length === 0)
+            throw new Error("No calls to preflight");
+        const result = await this.account.simulateTransaction([{ type: "INVOKE", payload: [...this._calls] }], { skipValidate: false });
+        if (!result || result.length === 0) {
+            throw new Error("Simulation returned no results");
+        }
+        return result[0];
+    }
+}
+//# sourceMappingURL=tx-builder.js.map

package/dist/transactions/tx-builder.js.map

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

package/dist/transactions/types.d.ts

@@ -0,0 +1,11 @@
+export interface TransferTarget {
+    to: string;
+    amount: bigint;
+}
+export interface PreflightResult {
+    transaction_trace: unknown;
+    fee_estimation: {
+        overall_fee: bigint;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transactions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transactions/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC"}

package/dist/transactions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transactions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transactions/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@chipi-stack/core",
+  "version": "0.2.1",
+  "description": "Core primitives for Chipi Pay SDK: TxBuilder, Amount, SignerAdapter, TokenRegistry",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@chipi-stack/types": "^14.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4",
+    "starknet": ">=6.23.1"
+  },
+  "peerDependencies": {
+    "starknet": ">=6.23.1"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}