phygital-payment-sdk 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# phygital-payment-sdk
+
+TypeScript SDK for on-chain, in-person NFC **tap-to-pay** on Solana.
+
+> **0.1.0 — early preview.** APIs may break. Not security-audited. Do not use for mainnet value
+> without your own review. In-memory provider stores are for development only — production providers
+> must supply durable `ReplayStore` / `ExposureStore` / `FeeBudgetStore` and HSM-backed enabler keys.
+
+```bash
+pnpm add phygital-payment-sdk @solana/kit
+```
+
+ESM only. `@solana/kit` `^6.4.0` is a peer dependency.
+
+**Program ID:** `Hy8HdxYZrPbAdMgMkL9ZVdJDNesZrihUVQLjoT16jacV`  
+This client is generated from that program’s IDL — keep program deploy and SDK version in lockstep.
+
+## Entry points
+
+| Import | Audience |
+|--------|----------|
+| `phygital-payment-sdk` | Merchant terminal, payer wallet, arbiter UI (browser-safe) |
+| `phygital-payment-sdk/server` | Payment provider (Node only — enabler co-sign, fee sponsor, stores, keeper, indexer) |
+| `phygital-payment-sdk/codama` | Raw Codama instruction builders (unstable) |
+
+Role guides (source of truth):
+[merchant](https://github.com/jychab/phygital-payment/blob/master/docs/merchant.md) ·
+[payer](https://github.com/jychab/phygital-payment/blob/master/docs/payer.md) ·
+[arbiter](https://github.com/jychab/phygital-payment/blob/master/docs/arbiter.md) ·
+[provider](https://github.com/jychab/phygital-payment/blob/master/docs/provider.md) ·
+[security](https://github.com/jychab/phygital-payment/blob/master/docs/security.md)
+
+## Merchant — take a payment
+
+```ts
+import { createMerchantClient, createProviderTransport } from "phygital-payment-sdk";
+
+const merchant = createMerchantClient({
+  rpc, rpcSubscriptions,
+  merchant: treasury,              // wallet, PDA, or multisig vault
+  treasurySigner,                  // only for refund / respond / operators
+  provider: createProviderTransport({ baseUrl: "https://provider.example", apiKey }),
+  // allowDeferral: false,         // opt out of deferred settlement (zero credit risk)
+});
+
+const result = await merchant.charge({
+  amount: 4_500_000n,
+  mint: usdcMint,
+  acceptArbiter: ({ reputation }) => (reputation?.score ?? 0) >= 0.9,
+  onProgress: (e) => render(e),    // awaitingTap → … → confirmed | queued
+});
+```
+
+## Payer — wallet setup
+
+```ts
+import { createWalletClient } from "phygital-payment-sdk";
+
+const wallet = createWalletClient({ rpc, rpcSubscriptions, owner });
+await wallet.setup({
+  mint: usdcMint, enablerPubkey, credential: { credentialId },
+  maxTapAmount: 100_000_000n,   // mandatory (fail-closed ceiling)
+  approvedArbiter,              // mandatory (registered Arbiter)
+  reserve: 50_000_000n,        // optional withdrawal floor
+});
+await wallet.deposit({ mint: usdcMint, amount: 100_000_000n });
+```
+
+## Arbiter — resolve disputes
+
+```ts
+import { createArbiterClient } from "phygital-payment-sdk";
+
+const arbiter = createArbiterClient({ rpc, arbiter: arbiterSigner, store: indexerStore });
+await arbiter.register();
+const open = await arbiter.listOpenDisputes();
+await arbiter.resolveForPayer(open[0]!.address);   // or resolveForMerchant / resolve({ merchantAmount })
+```
+
+## Provider — backend
+
+```ts
+import {
+  createEnablerService, createFeePayerService, createProviderRouter,
+  createEventIndexer, createKeeper,
+  createInMemoryReferenceStore, createInMemoryExposureStore,
+  createInMemoryIndexerStore, createInMemoryPendingTapStore,
+} from "phygital-payment-sdk/server";
+
+const exposureStore = createInMemoryExposureStore(); // replace with Redis/Postgres in production
+const enabler = createEnablerService({
+  rpc, signer,                                       // HSM-backed EnablerSigner in production
+  replayStore: createInMemoryReferenceStore(),       // REQUIRED
+  exposureStore,                                      // REQUIRED — atomic tryReserve
+  expectedOrigins: "https://pos.example",
+  expectedRPID: "pos.example",
+  policy: { maxAmountPerTap: 100_000_000n },
+});
+
+const indexer = createEventIndexer({
+  rpc, rpcSubscriptions,
+  store: createInMemoryIndexerStore(),
+  exposureStore,
+});
+indexer.subscribe();
+
+const handle = createProviderRouter({
+  enabler,
+  feePayer: createFeePayerService(feePayerKeypair, { maxPriorityFeeLamports: 100_000n }),
+  pendingTaps: createInMemoryPendingTapStore(),
+  verifyApiKey: (key) => key === process.env.API_KEY,
+});
+```
+
+Also run settlement/close cranks (`createKeeper`) with the **same** ed25519 key as the fee payer.
+See the [provider guide](https://github.com/jychab/phygital-payment/blob/master/docs/provider.md).
+
+## License
+
+ISC — see the [repository](https://github.com/jychab/phygital-payment).

package/dist/arbiter/client.d.ts

@@ -0,0 +1,34 @@
+import type { Address, RpcSubscriptions, Signature, SolanaRpcSubscriptionsApi, TransactionSigner } from "@solana/kit";
+import { type ArbiterReputation, type PaymentSummary, type SdkRpc } from "../core/payment.js";
+import type { IndexedPayment, IndexerStore } from "../core/indexer-store.js";
+export interface ArbiterClientConfig {
+    rpc: SdkRpc;
+    rpcSubscriptions?: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    arbiter: TransactionSigner;
+    store?: IndexerStore;
+}
+export interface ArbiterClient {
+    resolve(params: {
+        payment: Address;
+        merchantAmount: bigint;
+    }): Promise<{
+        signature: Signature;
+    }>;
+    resolveForMerchant(payment: Address): Promise<{
+        signature: Signature;
+    }>;
+    resolveForPayer(payment: Address): Promise<{
+        signature: Signature;
+    }>;
+    register(): Promise<{
+        signature?: Signature;
+        alreadyRegistered: boolean;
+    }>;
+    reputation(): Promise<ArbiterReputation | null>;
+    listOpenDisputes(options?: {
+        limit?: number;
+    }): Promise<IndexedPayment[]>;
+    getDispute(payment: Address): Promise<PaymentSummary | null>;
+}
+export declare function createArbiterClient(config: ArbiterClientConfig): ArbiterClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/arbiter/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EAEP,gBAAgB,EAChB,SAAS,EACT,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IAE/D,OAAO,EAAE,iBAAiB,CAAC;IAK3B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAM5B,OAAO,CAAC,MAAM,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAGtC,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAGxE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAOrE,QAAQ,IAAI,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,SAAS,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAG3E,UAAU,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAGhD,gBAAgB,CAAC,OAAO,CAAC,EAAE;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAG9B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC9D;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAkIf"}

package/dist/arbiter/client.js

@@ -0,0 +1,106 @@
+import { getCreateAssociatedTokenIdempotentInstructionAsync } from "@solana-program/token";
+import { getResolveDisputeInstruction } from "../generated/instructions/resolveDispute.js";
+import { getRegisterArbiterInstructionAsync } from "../generated/instructions/registerArbiter.js";
+import { ConfigurationError, InvalidAmountError } from "../core/errors.js";
+import { fetchArbiterReputation, fetchPaymentSummary, } from "../core/payment.js";
+import { deriveArbiterAddress, deriveAssociatedTokenAddress, deriveEscrowAddress, derivePaymentAccountAddress, } from "../core/pda.js";
+import { PaymentStatus } from "../core/status.js";
+import { createTransactionRuntime } from "../core/transactions.js";
+export function createArbiterClient(config) {
+    const runtime = createTransactionRuntime(config);
+    async function fetchDisputedOrThrow(payment) {
+        const summary = await fetchPaymentSummary(config.rpc, payment);
+        if (!summary) {
+            throw new ConfigurationError(`Payment ${payment} does not exist on-chain. It may have already been resolved (which closes the account).`);
+        }
+        if (summary.status !== PaymentStatus.Disputed) {
+            throw new ConfigurationError(`Payment ${payment} is not Disputed (status=${summary.status}).`);
+        }
+        if (summary.arbiter !== config.arbiter.address) {
+            throw new ConfigurationError(`Payment ${payment} is assigned to arbiter ${summary.arbiter}, not ${config.arbiter.address}.`);
+        }
+        return summary;
+    }
+    async function resolve(params) {
+        const summary = await fetchDisputedOrThrow(params.payment);
+        if (params.merchantAmount < 0n || params.merchantAmount > summary.amount) {
+            throw new InvalidAmountError(`merchantAmount ${params.merchantAmount} must be within [0, ${summary.amount}].`);
+        }
+        const paymentAccount = await derivePaymentAccountAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const escrowTokenAccount = await deriveEscrowAddress({
+            owner: summary.payer,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const merchantTokenAccount = await deriveAssociatedTokenAddress({
+            owner: summary.merchant,
+            mint: summary.mint,
+            tokenProgram: summary.tokenProgram,
+        });
+        const arbiterAccount = await deriveArbiterAddress(summary.arbiter);
+        const instructions = [
+            await getCreateAssociatedTokenIdempotentInstructionAsync({
+                payer: config.arbiter,
+                owner: summary.merchant,
+                mint: summary.mint,
+                tokenProgram: summary.tokenProgram,
+            }),
+            getResolveDisputeInstruction({
+                arbiter: config.arbiter,
+                paymentAccount,
+                payment: params.payment,
+                arbiterAccount,
+                escrowTokenAccount,
+                mint: summary.mint,
+                merchantTokenAccount,
+                tokenProgram: summary.tokenProgram,
+                merchantAmount: params.merchantAmount,
+            }),
+        ];
+        const signature = await runtime.sendAndConfirm(config.arbiter, instructions);
+        await config.store?.remove(params.payment);
+        return { signature };
+    }
+    return {
+        resolve,
+        async register() {
+            const existing = await fetchArbiterReputation(config.rpc, config.arbiter.address);
+            if (existing)
+                return { alreadyRegistered: true };
+            const instruction = await getRegisterArbiterInstructionAsync({
+                authority: config.arbiter,
+            });
+            const signature = await runtime.sendAndConfirm(config.arbiter, [
+                instruction,
+            ]);
+            return { signature, alreadyRegistered: false };
+        },
+        reputation() {
+            return fetchArbiterReputation(config.rpc, config.arbiter.address);
+        },
+        resolveForMerchant(payment) {
+            return fetchDisputedOrThrow(payment).then((summary) => resolve({ payment, merchantAmount: summary.amount }));
+        },
+        resolveForPayer(payment) {
+            return resolve({ payment, merchantAmount: 0n });
+        },
+        async listOpenDisputes(options = {}) {
+            if (!config.store) {
+                throw new ConfigurationError("listOpenDisputes requires an IndexerStore. Pass `store` to createArbiterClient, fed by createEventIndexer.");
+            }
+            return config.store.list({
+                status: PaymentStatus.Disputed,
+                arbiter: config.arbiter.address,
+                limit: options.limit,
+            });
+        },
+        getDispute(payment) {
+            return fetchPaymentSummary(config.rpc, payment);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/arbiter/client.js.map

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

package/dist/core/amounts.d.ts

@@ -0,0 +1,4 @@
+export declare function assertU64(amount: bigint): void;
+export declare function toBaseUnits(amount: string | number, decimals: number): bigint;
+export declare function fromBaseUnits(amount: bigint, decimals: number): string;
+//# sourceMappingURL=amounts.d.ts.map

package/dist/core/amounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.d.ts","sourceRoot":"","sources":["../../src/core/amounts.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9C;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB7E;AAGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtE"}

package/dist/core/amounts.js

@@ -0,0 +1,36 @@
+import { InvalidAmountError } from "./errors.js";
+const U64_MAX = 18446744073709551615n;
+export function assertU64(amount) {
+    if (amount < 0n || amount > U64_MAX) {
+        throw new InvalidAmountError(`Amount ${amount} is outside the valid u64 range.`);
+    }
+}
+export function toBaseUnits(amount, decimals) {
+    const text = typeof amount === "number" ? String(amount) : amount.trim();
+    const match = /^([0-9]+)(?:\.([0-9]*))?$/.exec(text);
+    if (!match) {
+        throw new InvalidAmountError(`Cannot parse amount "${amount}".`);
+    }
+    const whole = match[1];
+    const fraction = match[2] ?? "";
+    if (fraction.length > decimals) {
+        throw new InvalidAmountError(`Amount "${amount}" has more than ${decimals} decimal places.`);
+    }
+    const base = BigInt(whole) * 10n ** BigInt(decimals) +
+        BigInt(fraction.padEnd(decimals, "0") || "0");
+    assertU64(base);
+    return base;
+}
+export function fromBaseUnits(amount, decimals) {
+    assertU64(amount);
+    if (decimals === 0)
+        return amount.toString();
+    const divisor = 10n ** BigInt(decimals);
+    const whole = amount / divisor;
+    const fraction = (amount % divisor)
+        .toString()
+        .padStart(decimals, "0")
+        .replace(/0+$/, "");
+    return fraction.length > 0 ? `${whole}.${fraction}` : whole.toString();
+}
+//# sourceMappingURL=amounts.js.map

package/dist/core/amounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amounts.js","sourceRoot":"","sources":["../../src/core/amounts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,GAAG,qBAA2B,CAAC;AAG5C,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAC1B,UAAU,MAAM,kCAAkC,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAMD,MAAM,UAAU,WAAW,CAAC,MAAuB,EAAE,QAAgB;IACnE,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,MAAM,IAAI,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,WAAW,MAAM,mBAAmB,QAAQ,kBAAkB,CAC/D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GACR,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAChD,SAAS,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,SAAS,CAAC,MAAM,CAAC,CAAC;IAClB,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AACzE,CAAC"}

package/dist/core/bytes.d.ts

@@ -0,0 +1,11 @@
+export declare function concatBytes(...parts: readonly Uint8Array[]): Uint8Array;
+export declare function bytesToBase58(bytes: Uint8Array): string;
+export declare function base58ToBytes(value: string): Uint8Array;
+export declare function bytesToBase64Url(bytes: Uint8Array): string;
+export declare function base64UrlToBytes(value: string): Uint8Array;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array;
+export declare function randomReference(): Uint8Array;
+export declare function bytesEqualConstant(a: Uint8Array, b: Uint8Array): boolean;
+export declare function toUint8Array(bytes: ArrayLike<number>): Uint8Array;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/core/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/core/bytes.ts"],"names":[],"mappings":"AAOA,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CASvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAU1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAK1D;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CASvD;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAUvD;AAGD,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAOxE;AAGD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,UAAU,CAEjE"}

package/dist/core/bytes.js

@@ -0,0 +1,69 @@
+import { getBase58Decoder, getBase58Encoder } from "@solana/kit";
+export function concatBytes(...parts) {
+    const total = parts.reduce((sum, part) => sum + part.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+export function bytesToBase58(bytes) {
+    return getBase58Decoder().decode(bytes);
+}
+export function base58ToBytes(value) {
+    return new Uint8Array(getBase58Encoder().encode(value));
+}
+export function bytesToBase64Url(bytes) {
+    let binary = "";
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    const base64 = typeof btoa === "function"
+        ? btoa(binary)
+        : Buffer.from(bytes).toString("base64");
+    return base64.replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+export function base64UrlToBytes(value) {
+    const base64 = value.replaceAll("-", "+").replaceAll("_", "/") +
+        "=".repeat((4 - (value.length % 4)) % 4);
+    return base64ToBytes(base64);
+}
+export function bytesToBase64(bytes) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(bytes).toString("base64");
+    }
+    let binary = "";
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+export function base64ToBytes(value) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(value, "base64"));
+    }
+    const binary = atob(value);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        out[i] = binary.charCodeAt(i);
+    }
+    return out;
+}
+export function randomReference() {
+    return crypto.getRandomValues(new Uint8Array(32));
+}
+export function bytesEqualConstant(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++) {
+        diff |= a[i] ^ b[i];
+    }
+    return diff === 0;
+}
+export function toUint8Array(bytes) {
+    return Uint8Array.from(bytes);
+}
+//# sourceMappingURL=bytes.js.map

package/dist/core/bytes.js.map

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

package/dist/core/challenge.d.ts

@@ -0,0 +1,15 @@
+import { type Address } from "@solana/kit";
+export interface PaymentAuthorizationFields {
+    mint: Address;
+    amount: bigint | number;
+    merchant: Address;
+    programId?: Address;
+}
+export interface TapChallengeFields extends PaymentAuthorizationFields {
+    reference: Uint8Array;
+    issuedAt: number | bigint;
+}
+export declare function buildPaymentAuthorizationMessage({ mint, amount, merchant, programId, }: PaymentAuthorizationFields): Uint8Array;
+export declare function assertValidReference(reference: Uint8Array): void;
+export declare function buildTapChallenge(fields: TapChallengeFields): Uint8Array;
+//# sourceMappingURL=challenge.d.ts.map

package/dist/core/challenge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge.d.ts","sourceRoot":"","sources":["../../src/core/challenge.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAUrB,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,0BAA0B;IAEpE,SAAS,EAAE,UAAU,CAAC;IAEtB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAMD,wBAAgB,gCAAgC,CAAC,EAC/C,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,SAA4C,GAC7C,EAAE,0BAA0B,GAAG,UAAU,CAQzC;AAGD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI,CAShE;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,UAAU,CAWxE"}

package/dist/core/challenge.js

@@ -0,0 +1,24 @@
+import { getAddressEncoder, getU64Encoder, } from "@solana/kit";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { PHYGITAL_PAYMENT_PROGRAM_ADDRESS } from "../generated/programs/phygitalPayment.js";
+import { concatBytes } from "./bytes.js";
+import { InvalidReferenceError } from "./errors.js";
+const TAP_CHALLENGE_ACTION_BYTES = new TextEncoder().encode("phygital_pay:tap:v2");
+export function buildPaymentAuthorizationMessage({ mint, amount, merchant, programId = PHYGITAL_PAYMENT_PROGRAM_ADDRESS, }) {
+    const addressEncoder = getAddressEncoder();
+    return concatBytes(new Uint8Array(addressEncoder.encode(programId)), new Uint8Array(addressEncoder.encode(mint)), new Uint8Array(getU64Encoder().encode(amount)), new Uint8Array(addressEncoder.encode(merchant)));
+}
+export function assertValidReference(reference) {
+    if (reference.length !== 32) {
+        throw new InvalidReferenceError(`Payment reference must be exactly 32 bytes, got ${reference.length}.`);
+    }
+    if (reference.every((byte) => byte === 0)) {
+        throw new InvalidReferenceError("Payment reference must be non-zero.");
+    }
+}
+export function buildTapChallenge(fields) {
+    assertValidReference(fields.reference);
+    const messageHash = sha256(buildPaymentAuthorizationMessage(fields));
+    return sha256(concatBytes(TAP_CHALLENGE_ACTION_BYTES, messageHash, fields.reference, new Uint8Array(getU64Encoder().encode(fields.issuedAt))));
+}
+//# sourceMappingURL=challenge.js.map

package/dist/core/challenge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge.js","sourceRoot":"","sources":["../../src/core/challenge.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,iBAAiB,EACjB,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,0BAA0B,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACzD,qBAAqB,CACtB,CAAC;AAoBF,MAAM,UAAU,gCAAgC,CAAC,EAC/C,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,SAAS,GAAG,gCAAgC,GACjB;IAC3B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,OAAO,WAAW,CAChB,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAChD,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAC3C,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAC9C,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,oBAAoB,CAAC,SAAqB;IACxD,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,qBAAqB,CAC7B,mDAAmD,SAAS,CAAC,MAAM,GAAG,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,qBAAqB,CAAC,qCAAqC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,gCAAgC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,OAAO,MAAM,CACX,WAAW,CACT,0BAA0B,EAC1B,WAAW,EACX,MAAM,CAAC,SAAS,EAChB,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CACxD,CACF,CAAC;AACJ,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,90 @@
+import type { Signature } from "@solana/kit";
+export declare abstract class PhygitalPaymentSdkError extends Error {
+    abstract readonly code: string;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function programErrorName(errorCode: number): string;
+export declare class ProgramExecutionError extends PhygitalPaymentSdkError {
+    readonly code = "program_error";
+    readonly errorCode: number;
+    readonly errorName: string;
+    readonly signature?: Signature;
+    readonly logs?: readonly string[];
+    constructor(errorCode: number, ctx?: {
+        signature?: Signature;
+        logs?: readonly string[];
+        cause?: unknown;
+    });
+}
+export declare class SimulationError extends PhygitalPaymentSdkError {
+    readonly code = "simulation_failed";
+    readonly transactionError: unknown;
+    readonly logs?: readonly string[];
+    constructor(transactionError: unknown, ctx?: {
+        logs?: readonly string[];
+        cause?: unknown;
+    });
+}
+export declare class ProviderHttpError extends PhygitalPaymentSdkError {
+    readonly code = "provider_http_error";
+    readonly endpoint: "getEnablerSignature" | "listPendingTaps" | "acknowledgePendingTap" | "persistTransferResult" | "getFeePayer" | "signAsFeePayer";
+    readonly status: number;
+    readonly body?: string;
+    constructor(endpoint: ProviderHttpError["endpoint"], status: number, body?: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class TapReadError extends PhygitalPaymentSdkError {
+    readonly code = "tap_read_failed";
+    readonly aborted: boolean;
+    constructor(message: string, ctx?: {
+        aborted?: boolean;
+        cause?: unknown;
+    });
+}
+export declare class EnablerMismatchError extends PhygitalPaymentSdkError {
+    readonly code = "enabler_mismatch";
+    readonly expected: Uint8Array;
+    readonly actual: Uint8Array;
+    constructor(expected: Uint8Array, actual: Uint8Array);
+}
+export declare class PolicyViolationError extends PhygitalPaymentSdkError {
+    readonly code = "policy_violation";
+    readonly rule: string;
+    readonly detail?: string;
+    constructor(rule: string, detail?: string);
+}
+export declare class EnvironmentError extends PhygitalPaymentSdkError {
+    readonly code = "wrong_environment";
+}
+export declare class InvalidReferenceError extends PhygitalPaymentSdkError {
+    readonly code = "invalid_reference";
+}
+export declare class ConfigurationError extends PhygitalPaymentSdkError {
+    readonly code = "configuration_error";
+}
+export declare class InvalidAmountError extends PhygitalPaymentSdkError {
+    readonly code = "invalid_amount";
+}
+export declare class TapLimitError extends PhygitalPaymentSdkError {
+    readonly code = "tap_limit_exceeded";
+    readonly amount: bigint;
+    readonly limit: bigint;
+    constructor(amount: bigint, limit: bigint);
+}
+export declare class ArbiterNotApprovedError extends PhygitalPaymentSdkError {
+    readonly code = "arbiter_not_approved";
+}
+export declare class ArbiterRejectedError extends PhygitalPaymentSdkError {
+    readonly code = "arbiter_rejected";
+    readonly arbiter: string;
+    constructor(arbiter: string, detail?: string);
+}
+export declare function extractCustomErrorCode(transactionError: unknown): number | null;
+export declare function toSdkError(error: unknown, ctx?: {
+    signature?: Signature;
+    logs?: readonly string[];
+}): PhygitalPaymentSdkError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

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