@chipi-stack/core 0.2.1 → 0.3.1

package/README.md

@@ -82,6 +82,15 @@ const fee = await estimateFee(calls, account);
 const check = await preflight(calls, account); // fee + balance check
 ```
 
+## What you can ship
+
+- **Gasless wallets for gaming and loyalty apps** — abstract away gas fees so users never touch crypto
+- **Invisible signers for AI agents** — let autonomous agents sign and submit transactions
+- **Multi-call DeFi transactions** — batch swaps, approvals, and transfers into a single execution
+- **Custom payment flows for remittance platforms** — build cross-border payment rails on Starknet
+
+Have an idea? [Tell us what you want to build](https://github.com/chipi-pay/build-with-chipi/issues/new)
+
 ## Documentation
 
 Full docs at [docs.chipipay.com](https://docs.chipipay.com)

package/dist/index.d.ts

@@ -1,12 +1,16 @@
 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 { TxBuilder, type TxBuilderOptions } 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 { StarknetSignerAdapter } from "./signers/starknet-signer-adapter.js";
+export { createAccount } from "./signers/create-account.js";
+export type { CreateAccountOptions } from "./signers/create-account.js";
 export type { SignerAdapter, SignResult } from "./signers/types.js";
 export { estimateFee, preflight } from "./estimation/estimate-fee.js";
 export type { FeeEstimate } from "./estimation/types.js";
+export { X402Client, X402_DOMAIN, X402_TYPES, buildX402TypedData, type BuildX402SimpleParams, } from "./x402/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChF,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,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,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;AAGzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -8,6 +8,10 @@ export { TxBuilder } from "./transactions/tx-builder.js";
 export { DirectSigner } from "./signers/direct-signer.js";
 export { PasskeySigner } from "./signers/passkey-signer.js";
 export { ExternalSigner } from "./signers/external-signer.js";
+export { StarknetSignerAdapter } from "./signers/starknet-signer-adapter.js";
+export { createAccount } from "./signers/create-account.js";
 // Estimation
 export { estimateFee, preflight } from "./estimation/estimate-fee.js";
+// x402 Payment Protocol
+export { X402Client, X402_DOMAIN, X402_TYPES, buildX402TypedData, } from "./x402/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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,EAAyB,MAAM,8BAA8B,CAAC;AAGhF,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;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGtE,wBAAwB;AACxB,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC"}

package/dist/signers/create-account.d.ts

@@ -0,0 +1,21 @@
+import { Account } from "starknet";
+import type { ProviderInterface, ProviderOptions, CairoVersion } from "starknet";
+import type { SignerAdapter } from "./types.js";
+export interface CreateAccountOptions {
+    /** Any SignerAdapter implementation (DirectSigner, PasskeySigner, ExternalSigner). */
+    signer: SignerAdapter;
+    /** Starknet provider or provider options. */
+    provider: ProviderOptions | ProviderInterface;
+    /** Override the account address (defaults to signer.getAccountAddress()). */
+    address?: string;
+    /** Cairo version for the account contract. */
+    cairoVersion?: CairoVersion;
+}
+/**
+ * Create a starknet.js Account from any SignerAdapter.
+ *
+ * Bridges the gap between SignerAdapter and starknet.js Account,
+ * so you can use the Account with TxBuilder or any starknet.js API.
+ */
+export declare function createAccount(opts: CreateAccountOptions): Promise<Account>;
+//# sourceMappingURL=create-account.d.ts.map

package/dist/signers/create-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-account.d.ts","sourceRoot":"","sources":["../../src/signers/create-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,MAAM,EAAE,aAAa,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAC9C,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF"}

package/dist/signers/create-account.js

@@ -0,0 +1,19 @@
+import { Account } from "starknet";
+import { StarknetSignerAdapter } from "./starknet-signer-adapter.js";
+/**
+ * Create a starknet.js Account from any SignerAdapter.
+ *
+ * Bridges the gap between SignerAdapter and starknet.js Account,
+ * so you can use the Account with TxBuilder or any starknet.js API.
+ */
+export async function createAccount(opts) {
+    const address = opts.address ?? await opts.signer.getAccountAddress();
+    const signer = new StarknetSignerAdapter(opts.signer);
+    return new Account({
+        provider: opts.provider,
+        address,
+        signer,
+        cairoVersion: opts.cairoVersion,
+    });
+}
+//# sourceMappingURL=create-account.js.map

package/dist/signers/create-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-account.js","sourceRoot":"","sources":["../../src/signers/create-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAarE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,IAAI,OAAO,CAAC;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO;QACP,MAAM;QACN,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/signers/starknet-signer-adapter.d.ts

@@ -0,0 +1,18 @@
+import { Signer, type Signature } from "starknet";
+import type { SignerAdapter } from "./types.js";
+/**
+ * Bridge between SignerAdapter and starknet.js Signer.
+ *
+ * Extends starknet.js `Signer`, overriding `signRaw()` to delegate to
+ * `SignerAdapter.sign()`. All hash computation is handled by starknet.js.
+ *
+ * This allows any SignerAdapter (DirectSigner, PasskeySigner, ExternalSigner)
+ * to be used where starknet.js expects a Signer instance (e.g., Account constructor).
+ */
+export declare class StarknetSignerAdapter extends Signer {
+    private readonly adapter;
+    constructor(adapter: SignerAdapter);
+    getPubKey(): Promise<string>;
+    protected signRaw(msgHash: string): Promise<Signature>;
+}
+//# sourceMappingURL=starknet-signer-adapter.d.ts.map

package/dist/signers/starknet-signer-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starknet-signer-adapter.d.ts","sourceRoot":"","sources":["../../src/signers/starknet-signer-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,MAAM;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,aAAa;IAOnB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;cAIlB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAItE"}

package/dist/signers/starknet-signer-adapter.js

@@ -0,0 +1,26 @@
+import { Signer } from "starknet";
+/**
+ * Bridge between SignerAdapter and starknet.js Signer.
+ *
+ * Extends starknet.js `Signer`, overriding `signRaw()` to delegate to
+ * `SignerAdapter.sign()`. All hash computation is handled by starknet.js.
+ *
+ * This allows any SignerAdapter (DirectSigner, PasskeySigner, ExternalSigner)
+ * to be used where starknet.js expects a Signer instance (e.g., Account constructor).
+ */
+export class StarknetSignerAdapter extends Signer {
+    constructor(adapter) {
+        // Dummy private key — overridden methods never use it.
+        // Signer requires a key in its constructor, but we bypass all internal signing.
+        super("0x1");
+        this.adapter = adapter;
+    }
+    async getPubKey() {
+        return this.adapter.getPublicKey();
+    }
+    async signRaw(msgHash) {
+        const result = await this.adapter.sign(msgHash);
+        return [result.r, result.s];
+    }
+}
+//# sourceMappingURL=starknet-signer-adapter.js.map

package/dist/signers/starknet-signer-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starknet-signer-adapter.js","sourceRoot":"","sources":["../../src/signers/starknet-signer-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,UAAU,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,MAAM;IAG/C,YAAY,OAAsB;QAChC,uDAAuD;QACvD,gFAAgF;QAChF,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEQ,KAAK,CAAC,SAAS;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAEkB,KAAK,CAAC,OAAO,CAAC,OAAe;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF"}

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

@@ -1,4 +1,5 @@
 import type { Account, Call, InvokeFunctionResponse, EstimateFeeResponseOverhead } from "starknet";
+import type { PaymasterAdapter } from "@chipi-stack/types";
 import type { TransferTarget, PreflightResult } from "./types.js";
 /**
  * Fluent builder for batching Starknet calls.
@@ -10,11 +11,16 @@ import type { TransferTarget, PreflightResult } from "./types.js";
  *   .transfer(tokenAddr, [{ to: recipient, amount: 1000n }])
  *   .send();
  */
+export interface TxBuilderOptions {
+    /** PaymasterAdapter for gasless transactions via sendSponsored(). */
+    paymaster?: PaymasterAdapter;
+}
 export declare class TxBuilder {
     private readonly account;
+    private readonly paymaster?;
     private readonly _calls;
     private sent;
-    constructor(account: Account);
+    constructor(account: Account, opts?: TxBuilderOptions);
     /** Returns a copy of the current call batch. */
     calls(): Call[];
     /**
@@ -41,6 +47,18 @@ export declare class TxBuilder {
      * @throws If send() was already called
      */
     send(): Promise<InvokeFunctionResponse>;
+    /**
+     * Execute via a paymaster (gasless). Requires a PaymasterAdapter.
+     *
+     * The paymaster handles: prepare typed data -> sign -> submit.
+     * For external wallets (Argent X, Braavos), signing triggers the wallet popup.
+     *
+     * @returns Transaction hash
+     * @throws If no paymaster was configured
+     * @throws If no calls have been added
+     * @throws If sendSponsored() or send() was already called
+     */
+    sendSponsored(): Promise<string>;
     /**
      * Estimate fees for the current batch without executing.
      * @throws If no calls have been added

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

@@ -1 +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"}
+{"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,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAKrD,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;;;;;;;;;;OAUG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAYtC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAKzD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;CAW5C"}

package/dist/transactions/tx-builder.js

@@ -1,19 +1,10 @@
 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) {
+    constructor(account, opts) {
         this._calls = [];
         this.sent = false;
         this.account = account;
+        this.paymaster = opts?.paymaster;
     }
     /** Returns a copy of the current call batch. */
     calls() {
@@ -77,6 +68,28 @@ export class TxBuilder {
         const calls = [...this._calls];
         return this.account.execute(calls);
     }
+    /**
+     * Execute via a paymaster (gasless). Requires a PaymasterAdapter.
+     *
+     * The paymaster handles: prepare typed data -> sign -> submit.
+     * For external wallets (Argent X, Braavos), signing triggers the wallet popup.
+     *
+     * @returns Transaction hash
+     * @throws If no paymaster was configured
+     * @throws If no calls have been added
+     * @throws If sendSponsored() or send() was already called
+     */
+    async sendSponsored() {
+        if (!this.paymaster) {
+            throw new Error("No paymaster configured. Pass { paymaster } to TxBuilder constructor.");
+        }
+        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;
+        return this.paymaster.execute({ account: this.account, calls: [...this._calls] });
+    }
     /**
      * Estimate fees for the current batch without executing.
      * @throws If no calls have been added

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

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

package/dist/x402/client.d.ts

@@ -0,0 +1,112 @@
+import type { Account, TypedData } from "starknet";
+import type { PaymentRequirement, PaymentPayload, X402ClientConfig } from "@chipi-stack/types";
+/** SNIP-12 domain for x402 payments */
+export declare const X402_DOMAIN: {
+    name: string;
+    version: string;
+    chainId: string;
+};
+/** SNIP-12 typed data structure for x402 payment */
+export declare const X402_TYPES: {
+    StarknetDomain: {
+        name: string;
+        type: string;
+    }[];
+    Payment: {
+        name: string;
+        type: string;
+    }[];
+};
+/** Simple convenience params for buildX402TypedData */
+export interface BuildX402SimpleParams {
+    /** Sender address */
+    from: string;
+    /** Recipient address */
+    recipient: string;
+    /** Amount in USDC base units (string) */
+    amount: string;
+    /** Nonce for replay protection */
+    nonce: string;
+    /** Seconds until expiry (default: 300) */
+    expiry?: number;
+    /** Asset address (default: USDC mainnet) */
+    asset?: string;
+}
+/** Full message params (original API) */
+interface BuildX402FullMessage {
+    from_address: string;
+    to_address: string;
+    amount: string;
+    asset: string;
+    valid_until: string;
+    nonce: string;
+}
+/**
+ * Build the full SNIP-12 typed data object for an x402 payment.
+ * Centralises the structure so client, facilitator, and React hook stay in sync.
+ *
+ * @example
+ * ```typescript
+ * // Full params (original)
+ * buildX402TypedData({ from_address, to_address, amount, asset, valid_until, nonce })
+ *
+ * // Simple convenience params
+ * buildX402TypedData({ from: sender, recipient, amount, nonce, expiry: 300 })
+ * ```
+ */
+export declare function buildX402TypedData(message: BuildX402FullMessage | BuildX402SimpleParams): TypedData;
+/**
+ * Minimal fetch-compatible interfaces.
+ * These mirror the standard Fetch API but allow the client to work
+ * in both browser and Node.js (18+) environments without requiring DOM lib.
+ */
+interface FetchResponse {
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+/**
+ * x402 payment client for Starknet.
+ *
+ * Wraps fetch calls with automatic HTTP 402 payment handling.
+ * When a server returns 402 Payment Required, the client:
+ * 1. Parses the payment requirement from the response header
+ * 2. Validates against configured limits (max amount, allowed recipients)
+ * 3. Signs a SNIP-12 typed data payment message
+ * 4. Retries the request with the signed payment in the X-PAYMENT header
+ *
+ * Works with any Starknet Account (DirectSigner, passkey, session key, external wallet).
+ * When used with a session key account, payments are fully automatic (no user interaction).
+ */
+export declare class X402Client {
+    private readonly account;
+    private readonly config;
+    private readonly fetchFn;
+    constructor(account: Account, config?: X402ClientConfig);
+    /**
+     * Wrap a fetch call with x402 payment handling.
+     * If the server returns 402, automatically sign payment and retry.
+     */
+    fetch(url: string, init?: Record<string, any>): Promise<FetchResponse>;
+    /**
+     * Parse PAYMENT-REQUIRED header from 402 response.
+     */
+    parsePaymentRequired(response: FetchResponse): PaymentRequirement;
+    /**
+     * Validate payment requirement against client configuration limits.
+     * Throws if the payment would exceed maxPaymentAmount or recipient is not whitelisted.
+     */
+    validateRequirement(requirement: PaymentRequirement): void;
+    /**
+     * Sign a SNIP-12 typed data payment message for the given requirement.
+     * Returns a PaymentPayload ready to be sent as the X-PAYMENT header.
+     */
+    signPayment(requirement: PaymentRequirement): Promise<PaymentPayload>;
+    /**
+     * Retry the original request with the X-PAYMENT header containing the signed payment.
+     */
+    private retryWithPayment;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/x402/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAc/F,uCAAuC;AACvC,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,UAAU;;;;;;;;;CActB,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,GACpD,SAAS,CA0BX;AAED;;;;GAIG;AACH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/C;AAQD;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoE;IAC3F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAUvD;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAa5E;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,kBAAkB;IA+DjE;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAsC1D;;;OAGG;IACG,WAAW,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAkC3E;;OAEG;YACW,gBAAgB;CAgB/B"}

package/dist/x402/client.js

@@ -0,0 +1,270 @@
+/** USDC native address on Starknet mainnet */
+const USDC_MAINNET = "0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb";
+/** USDC decimals */
+const USDC_DECIMALS = 6;
+/** Header name for x402 payment requirement */
+const PAYMENT_REQUIRED_HEADER = "payment-required";
+/** Default header name for sending payment */
+const DEFAULT_PAYMENT_HEADER = "X-PAYMENT";
+/** SNIP-12 domain for x402 payments */
+export const X402_DOMAIN = {
+    name: "x402-starknet",
+    version: "1",
+    chainId: "SN_MAIN",
+};
+/** SNIP-12 typed data structure for x402 payment */
+export const X402_TYPES = {
+    StarknetDomain: [
+        { name: "name", type: "shortstring" },
+        { name: "version", type: "shortstring" },
+        { name: "chainId", type: "shortstring" },
+    ],
+    Payment: [
+        { name: "from_address", type: "ContractAddress" },
+        { name: "to_address", type: "ContractAddress" },
+        { name: "amount", type: "u256" },
+        { name: "asset", type: "ContractAddress" },
+        { name: "valid_until", type: "u128" },
+        { name: "nonce", type: "felt" },
+    ],
+};
+function isSimpleParams(params) {
+    return "recipient" in params && "from" in params;
+}
+/**
+ * Build the full SNIP-12 typed data object for an x402 payment.
+ * Centralises the structure so client, facilitator, and React hook stay in sync.
+ *
+ * @example
+ * ```typescript
+ * // Full params (original)
+ * buildX402TypedData({ from_address, to_address, amount, asset, valid_until, nonce })
+ *
+ * // Simple convenience params
+ * buildX402TypedData({ from: sender, recipient, amount, nonce, expiry: 300 })
+ * ```
+ */
+export function buildX402TypedData(message) {
+    let resolved;
+    if (isSimpleParams(message)) {
+        const validUntil = Math.floor(Date.now() / 1000) + (message.expiry ?? 300);
+        resolved = {
+            from_address: message.from,
+            to_address: message.recipient,
+            amount: message.amount,
+            asset: message.asset ?? USDC_MAINNET,
+            valid_until: String(validUntil),
+            nonce: message.nonce,
+        };
+    }
+    else {
+        resolved = message;
+    }
+    return {
+        types: X402_TYPES,
+        primaryType: "Payment",
+        domain: X402_DOMAIN,
+        message: {
+            ...resolved,
+            amount: { low: resolved.amount, high: "0" },
+        },
+    };
+}
+/**
+ * x402 payment client for Starknet.
+ *
+ * Wraps fetch calls with automatic HTTP 402 payment handling.
+ * When a server returns 402 Payment Required, the client:
+ * 1. Parses the payment requirement from the response header
+ * 2. Validates against configured limits (max amount, allowed recipients)
+ * 3. Signs a SNIP-12 typed data payment message
+ * 4. Retries the request with the signed payment in the X-PAYMENT header
+ *
+ * Works with any Starknet Account (DirectSigner, passkey, session key, external wallet).
+ * When used with a session key account, payments are fully automatic (no user interaction).
+ */
+export class X402Client {
+    constructor(account, config) {
+        this.account = account;
+        this.config = {
+            headerName: DEFAULT_PAYMENT_HEADER,
+            ...config,
+        };
+        // Use global fetch (available in Node 18+ and browsers)
+        this.fetchFn = globalThis.fetch;
+    }
+    /**
+     * Wrap a fetch call with x402 payment handling.
+     * If the server returns 402, automatically sign payment and retry.
+     */
+    async fetch(url, init) {
+        const response = await this.fetchFn(url, init);
+        if (response.status !== 402) {
+            return response;
+        }
+        const requirement = this.parsePaymentRequired(response);
+        this.validateRequirement(requirement);
+        const payment = await this.signPayment(requirement);
+        return this.retryWithPayment(url, init, payment);
+    }
+    /**
+     * Parse PAYMENT-REQUIRED header from 402 response.
+     */
+    parsePaymentRequired(response) {
+        const headerValue = response.headers.get(PAYMENT_REQUIRED_HEADER);
+        if (!headerValue) {
+            throw new Error("Server returned 402 but no PAYMENT-REQUIRED header. " +
+                "The server may not support x402 or is misconfigured.");
+        }
+        let requirement;
+        try {
+            requirement = JSON.parse(headerValue);
+        }
+        catch {
+            throw new Error(`Malformed PAYMENT-REQUIRED header: invalid JSON. Got: "${headerValue.slice(0, 100)}"`);
+        }
+        if (!requirement.scheme || !requirement.network || !requirement.maxAmountRequired) {
+            throw new Error("Invalid payment requirement: missing required fields (scheme, network, maxAmountRequired)");
+        }
+        if (requirement.scheme !== "exact") {
+            throw new Error(`Unsupported payment scheme: "${requirement.scheme}". Only "exact" is supported.`);
+        }
+        if (requirement.network !== "starknet-mainnet") {
+            throw new Error(`Unsupported network: "${requirement.network}". Only "starknet-mainnet" is supported.`);
+        }
+        if (!requirement.payTo) {
+            throw new Error("Invalid payment requirement: missing payTo address");
+        }
+        if (!requirement.asset) {
+            throw new Error("Invalid payment requirement: missing asset address");
+        }
+        if (typeof requirement.maxTimeoutSeconds !== "number" || requirement.maxTimeoutSeconds <= 0) {
+            throw new Error("Invalid payment requirement: maxTimeoutSeconds must be a positive number");
+        }
+        try {
+            const parsedAmount = BigInt(requirement.maxAmountRequired);
+            if (parsedAmount <= 0n) {
+                throw new Error("non-positive");
+            }
+        }
+        catch {
+            throw new Error(`Invalid payment requirement: maxAmountRequired must be a positive integer, got "${requirement.maxAmountRequired}"`);
+        }
+        return requirement;
+    }
+    /**
+     * Validate payment requirement against client configuration limits.
+     * Throws if the payment would exceed maxPaymentAmount or recipient is not whitelisted.
+     */
+    validateRequirement(requirement) {
+        // Validate payment amount
+        if (this.config.maxPaymentAmount) {
+            const maxBaseUnits = humanUsdcToBaseUnits(this.config.maxPaymentAmount, USDC_DECIMALS);
+            const requiredAmount = BigInt(requirement.maxAmountRequired);
+            if (requiredAmount > maxBaseUnits) {
+                const requiredHuman = (Number(requiredAmount) / 10 ** USDC_DECIMALS).toFixed(USDC_DECIMALS);
+                throw new Error(`Payment amount ${requiredHuman} USDC exceeds maximum allowed ${this.config.maxPaymentAmount} USDC`);
+            }
+        }
+        // Validate recipient whitelist
+        if (this.config.allowedRecipients && this.config.allowedRecipients.length > 0) {
+            const normalizedPayTo = requirement.payTo.toLowerCase();
+            const isAllowed = this.config.allowedRecipients.some((addr) => addr.toLowerCase() === normalizedPayTo);
+            if (!isAllowed) {
+                throw new Error(`Recipient ${requirement.payTo} is not in the allowed recipients list`);
+            }
+        }
+        // Validate asset is USDC
+        const normalizedAsset = requirement.asset.toLowerCase().replace(/^0x0+/, "0x");
+        const normalizedUsdc = USDC_MAINNET.toLowerCase().replace(/^0x0+/, "0x");
+        if (normalizedAsset !== normalizedUsdc) {
+            throw new Error(`Unsupported asset: ${requirement.asset}. Only USDC (${USDC_MAINNET}) is supported.`);
+        }
+    }
+    /**
+     * Sign a SNIP-12 typed data payment message for the given requirement.
+     * Returns a PaymentPayload ready to be sent as the X-PAYMENT header.
+     */
+    async signPayment(requirement) {
+        const nonce = generateNonce();
+        const validUntil = Math.floor(Date.now() / 1000) + requirement.maxTimeoutSeconds;
+        const typedData = buildX402TypedData({
+            from_address: this.account.address,
+            to_address: requirement.payTo,
+            amount: requirement.maxAmountRequired,
+            asset: requirement.asset,
+            valid_until: String(validUntil),
+            nonce,
+        });
+        const signature = await this.account.signMessage(typedData);
+        // Normalize signature to { r, s } format
+        const normalizedSig = normalizeX402Signature(signature);
+        return {
+            x402Version: 1,
+            scheme: "exact",
+            network: "starknet-mainnet",
+            payload: {
+                signature: normalizedSig,
+                fromAddress: this.account.address,
+                toAddress: requirement.payTo,
+                amount: requirement.maxAmountRequired,
+                asset: requirement.asset,
+                validUntil,
+                nonce,
+            },
+        };
+    }
+    /**
+     * Retry the original request with the X-PAYMENT header containing the signed payment.
+     */
+    async retryWithPayment(url, init, payment) {
+        const existingHeaders = init?.headers ?? {};
+        const headers = {
+            ...existingHeaders,
+            [this.config.headerName]: JSON.stringify(payment),
+        };
+        return this.fetchFn(url, {
+            ...init,
+            headers,
+        });
+    }
+}
+/**
+ * Convert human-readable USDC amount to base units using string arithmetic (no float).
+ */
+function humanUsdcToBaseUnits(amount, decimals) {
+    const [whole, frac = ""] = amount.trim().split(".");
+    const fracPadded = (frac + "0".repeat(decimals)).slice(0, decimals);
+    return BigInt((whole || "0") + fracPadded);
+}
+/**
+ * Generate a unique nonce for replay protection.
+ * Uses crypto.randomUUID when available, falls back to timestamp + random.
+ */
+function generateNonce() {
+    if (typeof globalThis.crypto?.randomUUID === "function") {
+        return globalThis.crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Normalize signature from account.signMessage() to { r, s } string format.
+ * Handles WeierstrassSignatureType ({r, s} as bigint) and ArraySignatureType ([r, s]).
+ */
+function normalizeX402Signature(signature) {
+    if (Array.isArray(signature)) {
+        if (signature.length < 2) {
+            throw new Error(`Array signature must have at least 2 elements, got ${signature.length}`);
+        }
+        return { r: String(signature[0]), s: String(signature[1]) };
+    }
+    if (signature && typeof signature === "object" && "r" in signature && "s" in signature) {
+        const sig = signature;
+        if (sig.r == null || sig.s == null) {
+            throw new Error("Invalid signature object: r and s must be non-null");
+        }
+        return { r: String(sig.r), s: String(sig.s) };
+    }
+    throw new Error("Unrecognized signature format from account.signMessage()");
+}
+//# sourceMappingURL=client.js.map

package/dist/x402/client.js.map

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

package/dist/x402/index.d.ts

@@ -0,0 +1,2 @@
+export { X402Client, X402_DOMAIN, X402_TYPES, buildX402TypedData, type BuildX402SimpleParams, } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/x402/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC"}

package/dist/x402/index.js

@@ -0,0 +1,2 @@
+export { X402Client, X402_DOMAIN, X402_TYPES, buildX402TypedData, } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/x402/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,GAEnB,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chipi-stack/core",
-  "version": "0.2.1",
-  "description": "Core primitives for Chipi Pay SDK: TxBuilder, Amount, SignerAdapter, TokenRegistry",
+  "version": "0.3.1",
+  "description": "Gasless wallet primitives for Starknet — TxBuilder, SignerAdapter, TokenRegistry, and account abstraction core",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,24 +14,61 @@
   "files": [
     "dist"
   ],
+  "keywords": [
+    "chipi",
+    "chipi-pay",
+    "chipi-stack",
+    "starknet",
+    "starkware",
+    "ethereum",
+    "l2",
+    "web3",
+    "blockchain",
+    "wallet",
+    "smart-account",
+    "account-abstraction",
+    "gasless",
+    "payments",
+    "crypto-payments",
+    "stablecoin-payments",
+    "stablecoins",
+    "usdc",
+    "sdk",
+    "typescript",
+    "ai-payments",
+    "agent-payments"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chipi-pay/build-with-chipi.git"
+  },
+  "homepage": "https://docs.chipipay.com",
+  "bugs": {
+    "url": "https://github.com/chipi-pay/build-with-chipi/issues"
+  },
+  "author": {
+    "name": "Chipi Pay",
+    "email": "carlos@chipipay.com",
+    "url": "https://chipipay.com"
+  },
+  "license": "MIT",
   "dependencies": {
-    "@chipi-stack/types": "^14.0.0"
+    "@chipi-stack/types": "^14.1.1"
   },
   "devDependencies": {
     "typescript": "^5.7.3",
     "vitest": "^3.2.4",
-    "starknet": ">=6.23.1"
+    "starknet": ">=9.2.1"
   },
   "peerDependencies": {
-    "starknet": ">=6.23.1"
+    "starknet": ">=9.2.1"
   },
   "engines": {
-    "node": ">=18.17.0"
+    "node": ">=20.19.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT",
   "scripts": {
     "build": "tsc",
     "test": "vitest run",