phygital-payment-sdk 0.1.0

package/dist/core/execution-plan.js

@@ -0,0 +1,57 @@
+import { PROTOCOL_CONSTANTS, nowSeconds } from "./time.js";
+function earliestBindingConfigChange(config, amount, now) {
+    const horizons = [];
+    if (config.enablerEffectiveAt > now)
+        horizons.push(config.enablerEffectiveAt);
+    if (config.credentialEffectiveAt > now)
+        horizons.push(config.credentialEffectiveAt);
+    if (config.arbiterEffectiveAt > now)
+        horizons.push(config.arbiterEffectiveAt);
+    if (config.tapLimitEffectiveAt > now && amount > config.pendingMaxTapAmount) {
+        horizons.push(config.tapLimitEffectiveAt);
+    }
+    return horizons.length > 0 ? Math.min(...horizons) : null;
+}
+const COMFORT_MULTIPLIER = 10n;
+export function computeExecutionPlan(account, amount, now = nowSeconds(), exposure, config) {
+    let cover = account.reserveAmount < account.pendingReserveAmount
+        ? account.reserveAmount
+        : account.pendingReserveAmount;
+    if (exposure) {
+        const available = exposure.freeEscrow > exposure.outstandingExposure
+            ? exposure.freeEscrow - exposure.outstandingExposure
+            : 0n;
+        if (available < cover) {
+            cover = available;
+        }
+    }
+    let plan;
+    if (cover < amount * COMFORT_MULTIPLIER) {
+        if (account.reserveAmount < amount || cover < amount) {
+            return { mode: "immediate" };
+        }
+        if (account.reserveEffectiveAt <= now) {
+            return { mode: "immediate" };
+        }
+        plan = { mode: "deferred", executeBy: account.reserveEffectiveAt };
+    }
+    else {
+        plan = {
+            mode: "deferred",
+            executeBy: now + PROTOCOL_CONSTANTS.authorizationTtlSecs,
+        };
+    }
+    if (plan.mode === "deferred" && config) {
+        const horizon = earliestBindingConfigChange(config, amount, now);
+        if (horizon !== null && horizon < plan.executeBy) {
+            return { mode: "deferred", executeBy: horizon };
+        }
+    }
+    return plan;
+}
+export function clampExecuteBy(claimed, serverPlan) {
+    if (serverPlan.mode === "immediate")
+        return null;
+    return Math.min(claimed, serverPlan.executeBy);
+}
+//# sourceMappingURL=execution-plan.js.map

package/dist/core/execution-plan.js.map

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

package/dist/core/indexer-store.d.ts

@@ -0,0 +1,31 @@
+import type { Address, Signature } from "@solana/kit";
+import type { PaymentStatus } from "./status.js";
+export interface IndexedPayment {
+    address: Address;
+    payer: Address;
+    merchant: Address;
+    mint: Address;
+    arbiter: Address;
+    amount: bigint;
+    status: PaymentStatus;
+    merchantResponded: boolean;
+    captureAfter: number;
+    disputedAt: number;
+    respondedAt: number;
+    lastSignature: Signature;
+    updatedAt: number;
+}
+export interface IndexerStore {
+    upsert(payment: IndexedPayment): Promise<void> | void;
+    remove(address: Address): Promise<void> | void;
+    get(address: Address): Promise<IndexedPayment | null> | IndexedPayment | null;
+    list(filter?: {
+        status?: PaymentStatus | readonly PaymentStatus[];
+        merchant?: Address;
+        arbiter?: Address;
+        payer?: Address;
+        deadlineAtOrBefore?: number;
+        limit?: number;
+    }): Promise<IndexedPayment[]> | IndexedPayment[];
+}
+//# sourceMappingURL=indexer-store.d.ts.map

package/dist/core/indexer-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-store.d.ts","sourceRoot":"","sources":["../../src/core/indexer-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,EAAE,SAAS,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC;IAE9E,IAAI,CAAC,MAAM,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,CAAC;QAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC;CAClD"}

package/dist/core/indexer-store.js

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

package/dist/core/indexer-store.js.map

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

package/dist/core/instruction-codec.d.ts

@@ -0,0 +1,13 @@
+import { type Instruction } from "@solana/kit";
+export interface WireInstructionAccount {
+    address: string;
+    role: 0 | 1 | 2 | 3;
+}
+export interface WireInstruction {
+    programAddress: string;
+    accounts: WireInstructionAccount[];
+    data: string;
+}
+export declare function serializeInstructions(instructions: readonly Instruction[]): WireInstruction[];
+export declare function deserializeInstructions(wire: readonly WireInstruction[]): Instruction[];
+//# sourceMappingURL=instruction-codec.d.ts.map

package/dist/core/instruction-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-codec.d.ts","sourceRoot":"","sources":["../../src/core/instruction-codec.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IAEnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,eAAe,EAAE,CAWnB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,eAAe,EAAE,GAC/B,WAAW,EAAE,CASf"}

package/dist/core/instruction-codec.js

@@ -0,0 +1,23 @@
+import { AccountRole, } from "@solana/kit";
+import { base64UrlToBytes, bytesToBase64Url } from "./bytes.js";
+export function serializeInstructions(instructions) {
+    return instructions.map((instruction) => ({
+        programAddress: instruction.programAddress,
+        accounts: (instruction.accounts ?? []).map((account) => ({
+            address: account.address,
+            role: account.role,
+        })),
+        data: bytesToBase64Url(instruction.data ? new Uint8Array(instruction.data) : new Uint8Array(0)),
+    }));
+}
+export function deserializeInstructions(wire) {
+    return wire.map((instruction) => ({
+        programAddress: instruction.programAddress,
+        accounts: instruction.accounts.map((account) => ({
+            address: account.address,
+            role: account.role,
+        })),
+        data: base64UrlToBytes(instruction.data),
+    }));
+}
+//# sourceMappingURL=instruction-codec.js.map

package/dist/core/instruction-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-codec.js","sourceRoot":"","sources":["../../src/core/instruction-codec.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAehE,MAAM,UAAU,qBAAqB,CACnC,YAAoC;IAEpC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,cAAc,EAAE,WAAW,CAAC,cAAwB;QACpD,QAAQ,EAAE,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,CAAC,OAAiB;YAClC,IAAI,EAAE,OAAO,CAAC,IAAsC;SACrD,CAAC,CAAC;QACH,IAAI,EAAE,gBAAgB,CACpB,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CACxE;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAgC;IAEhC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChC,cAAc,EAAE,WAAW,CAAC,cAAyB;QACrD,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,CAAC,OAAkB;YACnC,IAAI,EAAE,OAAO,CAAC,IAAmB;SAClC,CAAC,CAAC;QACH,IAAI,EAAE,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/core/payment.d.ts

@@ -0,0 +1,116 @@
+import type { Account, Address, Rpc, SolanaRpcApi } from "@solana/kit";
+import { type Payment } from "../generated/accounts/payment.js";
+import { type PaymentAccount } from "../generated/accounts/paymentAccount.js";
+import { type PaymentStatus } from "./status.js";
+export type SdkRpc = Rpc<SolanaRpcApi>;
+export interface PaymentSummary {
+    address: Address;
+    payer: Address;
+    merchant: Address;
+    mint: Address;
+    tokenProgram: Address;
+    arbiter: Address;
+    amount: bigint;
+    bondAmount: bigint;
+    reference: Uint8Array;
+    referenceBase58: string;
+    status: PaymentStatus;
+    merchantResponded: boolean;
+    issuedAt: number;
+    captureAfter: number;
+    disputedAt: number;
+    respondedAt: number;
+    payerEvidenceHash: Uint8Array;
+    merchantEvidenceHash: Uint8Array;
+    rentPayer: Address;
+    raw: Account<Payment>;
+}
+export interface ArbiterReputation {
+    arbiter: Address;
+    authority: Address;
+    resolutions: number;
+    timeouts: number;
+    assigned: number;
+    score: number;
+}
+export declare function fetchArbiterReputation(rpc: SdkRpc, authority: Address): Promise<ArbiterReputation | null>;
+export declare function toPaymentSummary(account: Account<Payment>): PaymentSummary;
+export declare function fetchPaymentSummary(rpc: SdkRpc, address: Address): Promise<PaymentSummary | null>;
+export interface PaymentAccountSummary {
+    address: Address;
+    owner: Address;
+    mint: Address;
+    tokenProgram: Address;
+    enablerPubkey: Uint8Array;
+    pendingEnablerPubkey: Uint8Array;
+    enablerEffectiveAt: number;
+    credentialPubkey: Uint8Array;
+    pendingCredentialPubkey: Uint8Array;
+    credentialEffectiveAt: number;
+    amountLocked: bigint;
+    reserveAmount: bigint;
+    pendingReserveAmount: bigint;
+    reserveEffectiveAt: number;
+    maxTapAmount: bigint;
+    pendingMaxTapAmount: bigint;
+    tapLimitEffectiveAt: number;
+    approvedArbiter: Address;
+    pendingApprovedArbiter: Address;
+    arbiterEffectiveAt: number;
+    disputeStrikes: number;
+    lastStrikeAt: number;
+    raw: Account<PaymentAccount>;
+}
+export interface EscrowBalance {
+    total: bigint;
+    locked: bigint;
+    free: bigint;
+    reserve: bigint;
+    pendingReserve: bigint;
+    reserveEffectiveAt: number;
+    effectiveReserve: bigint;
+    withdrawable: bigint;
+}
+export declare function effectiveReserve(account: Pick<PaymentAccountSummary, "reserveAmount" | "pendingReserveAmount" | "reserveEffectiveAt">, now?: number): bigint;
+export declare function effectiveMaxTapAmount(account: Pick<PaymentAccountSummary, "maxTapAmount" | "pendingMaxTapAmount" | "tapLimitEffectiveAt">, now?: number): bigint;
+export declare function effectiveApprovedArbiter(account: Pick<PaymentAccountSummary, "approvedArbiter" | "pendingApprovedArbiter" | "arbiterEffectiveAt">, now?: number): Address;
+export declare function effectiveEnablerPubkey(account: Pick<PaymentAccountSummary, "enablerPubkey" | "pendingEnablerPubkey" | "enablerEffectiveAt">, now?: number): Uint8Array;
+export declare function effectiveCredentialPubkey(account: Pick<PaymentAccountSummary, "credentialPubkey" | "pendingCredentialPubkey" | "credentialEffectiveAt">, now?: number): Uint8Array;
+export type PendingSettingsChange = {
+    kind: "reserve";
+    effectiveAt: number;
+    current: bigint;
+    pending: bigint;
+} | {
+    kind: "tapLimit";
+    effectiveAt: number;
+    current: bigint;
+    pending: bigint;
+} | {
+    kind: "arbiter";
+    effectiveAt: number;
+    current: Address;
+    pending: Address;
+} | {
+    kind: "enabler";
+    effectiveAt: number;
+    current: Uint8Array;
+    pending: Uint8Array;
+} | {
+    kind: "credential";
+    effectiveAt: number;
+    current: Uint8Array;
+    pending: Uint8Array;
+};
+export declare function listPendingSettingsChanges(account: PaymentAccountSummary, now?: number): PendingSettingsChange[];
+export declare function fetchPaymentAccountSummary(rpc: SdkRpc, seeds: {
+    owner: Address;
+    mint: Address;
+    tokenProgram?: Address;
+}): Promise<PaymentAccountSummary | null>;
+export declare function fetchEscrowBalance(rpc: SdkRpc, seeds: {
+    owner: Address;
+    mint: Address;
+    tokenProgram?: Address;
+}, now?: number): Promise<EscrowBalance | null>;
+//# sourceMappingURL=payment.d.ts.map

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

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

package/dist/core/payment.js

@@ -0,0 +1,185 @@
+import { fetchToken, TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
+import { fetchMaybePayment, } from "../generated/accounts/payment.js";
+import { fetchMaybePaymentAccount, } from "../generated/accounts/paymentAccount.js";
+import { fetchMaybeArbiter } from "../generated/accounts/arbiter.js";
+import { bytesToBase58, toUint8Array } from "./bytes.js";
+import { deriveArbiterAddress, deriveEscrowAddress, derivePaymentAccountAddress, } from "./pda.js";
+import { decodePaymentFlags } from "./status.js";
+import { nowSeconds } from "./time.js";
+export async function fetchArbiterReputation(rpc, authority) {
+    const address = await deriveArbiterAddress(authority);
+    const account = await fetchMaybeArbiter(rpc, address);
+    if (!account.exists)
+        return null;
+    const resolutions = Number(account.data.resolutions);
+    const timeouts = Number(account.data.timeouts);
+    const total = resolutions + timeouts;
+    return {
+        arbiter: address,
+        authority: account.data.authority,
+        resolutions,
+        timeouts,
+        assigned: Number(account.data.assigned),
+        score: total === 0 ? 1 : resolutions / total,
+    };
+}
+export function toPaymentSummary(account) {
+    const { data } = account;
+    const flags = decodePaymentFlags(data.flags);
+    const reference = toUint8Array(data.reference);
+    return {
+        address: account.address,
+        payer: data.payer,
+        merchant: data.merchant,
+        mint: data.mint,
+        tokenProgram: data.tokenProgram,
+        arbiter: data.arbiter,
+        amount: data.amount,
+        bondAmount: data.bondAmount,
+        reference,
+        referenceBase58: bytesToBase58(reference),
+        status: flags.status,
+        merchantResponded: flags.merchantResponded,
+        issuedAt: data.issuedAt,
+        captureAfter: data.captureAfter,
+        disputedAt: data.disputedAt,
+        respondedAt: data.respondedAt,
+        payerEvidenceHash: toUint8Array(data.payerEvidenceHash),
+        merchantEvidenceHash: toUint8Array(data.merchantEvidenceHash),
+        rentPayer: data.rentPayer,
+        raw: account,
+    };
+}
+export async function fetchPaymentSummary(rpc, address) {
+    const account = await fetchMaybePayment(rpc, address);
+    return account.exists ? toPaymentSummary(account) : null;
+}
+export function effectiveReserve(account, now = nowSeconds()) {
+    return account.reserveEffectiveAt !== 0 && now >= account.reserveEffectiveAt
+        ? account.pendingReserveAmount
+        : account.reserveAmount;
+}
+export function effectiveMaxTapAmount(account, now = nowSeconds()) {
+    return account.tapLimitEffectiveAt !== 0 && now >= account.tapLimitEffectiveAt
+        ? account.pendingMaxTapAmount
+        : account.maxTapAmount;
+}
+export function effectiveApprovedArbiter(account, now = nowSeconds()) {
+    return account.arbiterEffectiveAt !== 0 && now >= account.arbiterEffectiveAt
+        ? account.pendingApprovedArbiter
+        : account.approvedArbiter;
+}
+export function effectiveEnablerPubkey(account, now = nowSeconds()) {
+    return account.enablerEffectiveAt !== 0 && now >= account.enablerEffectiveAt
+        ? account.pendingEnablerPubkey
+        : account.enablerPubkey;
+}
+export function effectiveCredentialPubkey(account, now = nowSeconds()) {
+    return account.credentialEffectiveAt !== 0 &&
+        now >= account.credentialEffectiveAt
+        ? account.pendingCredentialPubkey
+        : account.credentialPubkey;
+}
+export function listPendingSettingsChanges(account, now = nowSeconds()) {
+    const items = [];
+    if (account.reserveEffectiveAt !== 0 && now < account.reserveEffectiveAt) {
+        items.push({
+            kind: "reserve",
+            effectiveAt: account.reserveEffectiveAt,
+            current: account.reserveAmount,
+            pending: account.pendingReserveAmount,
+        });
+    }
+    if (account.tapLimitEffectiveAt !== 0 && now < account.tapLimitEffectiveAt) {
+        items.push({
+            kind: "tapLimit",
+            effectiveAt: account.tapLimitEffectiveAt,
+            current: account.maxTapAmount,
+            pending: account.pendingMaxTapAmount,
+        });
+    }
+    if (account.arbiterEffectiveAt !== 0 && now < account.arbiterEffectiveAt) {
+        items.push({
+            kind: "arbiter",
+            effectiveAt: account.arbiterEffectiveAt,
+            current: account.approvedArbiter,
+            pending: account.pendingApprovedArbiter,
+        });
+    }
+    if (account.enablerEffectiveAt !== 0 && now < account.enablerEffectiveAt) {
+        items.push({
+            kind: "enabler",
+            effectiveAt: account.enablerEffectiveAt,
+            current: account.enablerPubkey,
+            pending: account.pendingEnablerPubkey,
+        });
+    }
+    if (account.credentialEffectiveAt !== 0 &&
+        now < account.credentialEffectiveAt) {
+        items.push({
+            kind: "credential",
+            effectiveAt: account.credentialEffectiveAt,
+            current: account.credentialPubkey,
+            pending: account.pendingCredentialPubkey,
+        });
+    }
+    items.sort((a, b) => a.effectiveAt - b.effectiveAt);
+    return items;
+}
+export async function fetchPaymentAccountSummary(rpc, seeds) {
+    const address = await derivePaymentAccountAddress(seeds);
+    const account = await fetchMaybePaymentAccount(rpc, address);
+    if (!account.exists)
+        return null;
+    const { data } = account;
+    return {
+        address,
+        owner: seeds.owner,
+        mint: seeds.mint,
+        tokenProgram: seeds.tokenProgram ?? TOKEN_PROGRAM_ADDRESS,
+        enablerPubkey: toUint8Array(data.enablerPubkey),
+        pendingEnablerPubkey: toUint8Array(data.pendingEnablerPubkey),
+        enablerEffectiveAt: data.enablerEffectiveAt,
+        credentialPubkey: toUint8Array(data.credentialPubkey),
+        pendingCredentialPubkey: toUint8Array(data.pendingCredentialPubkey),
+        credentialEffectiveAt: data.credentialEffectiveAt,
+        amountLocked: data.amountLocked,
+        reserveAmount: data.reserveAmount,
+        pendingReserveAmount: data.pendingReserveAmount,
+        reserveEffectiveAt: data.reserveEffectiveAt,
+        maxTapAmount: data.maxTapAmount,
+        pendingMaxTapAmount: data.pendingMaxTapAmount,
+        tapLimitEffectiveAt: data.tapLimitEffectiveAt,
+        approvedArbiter: data.approvedArbiter,
+        pendingApprovedArbiter: data.pendingApprovedArbiter,
+        arbiterEffectiveAt: data.arbiterEffectiveAt,
+        disputeStrikes: data.disputeStrikes,
+        lastStrikeAt: data.lastStrikeAt,
+        raw: account,
+    };
+}
+export async function fetchEscrowBalance(rpc, seeds, now = nowSeconds()) {
+    const [summary, escrowAddress] = await Promise.all([
+        fetchPaymentAccountSummary(rpc, seeds),
+        deriveEscrowAddress(seeds),
+    ]);
+    if (summary === null)
+        return null;
+    const escrow = await fetchToken(rpc, escrowAddress);
+    const total = escrow.data.amount;
+    const locked = summary.amountLocked;
+    const free = total - locked;
+    const reserve = effectiveReserve(summary, now);
+    const withdrawable = free > reserve ? free - reserve : 0n;
+    return {
+        total,
+        locked,
+        free,
+        reserve: summary.reserveAmount,
+        pendingReserve: summary.pendingReserveAmount,
+        reserveEffectiveAt: summary.reserveEffectiveAt,
+        effectiveReserve: reserve,
+        withdrawable,
+    };
+}
+//# sourceMappingURL=payment.js.map

package/dist/core/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/core/payment.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EACL,iBAAiB,GAElB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,GAEzB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAsB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA+CvC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAW,EACX,SAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS;QACjC,WAAW;QACX,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QACvC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,KAAK;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS;QACT,eAAe,EAAE,aAAa,CAAC,SAAS,CAAC;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,iBAAiB,EAAE,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACvD,oBAAoB,EAAE,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC;QAC7D,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,OAAO;KACb,CAAC;AACJ,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AA+CD,MAAM,UAAU,gBAAgB,CAC9B,OAGC,EACD,MAAc,UAAU,EAAE;IAE1B,OAAO,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,kBAAkB;QAC1E,CAAC,CAAC,OAAO,CAAC,oBAAoB;QAC9B,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;AAC5B,CAAC;AAGD,MAAM,UAAU,qBAAqB,CACnC,OAGC,EACD,MAAc,UAAU,EAAE;IAE1B,OAAO,OAAO,CAAC,mBAAmB,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,mBAAmB;QAC5E,CAAC,CAAC,OAAO,CAAC,mBAAmB;QAC7B,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;AAC3B,CAAC;AAGD,MAAM,UAAU,wBAAwB,CACtC,OAGC,EACD,MAAc,UAAU,EAAE;IAE1B,OAAO,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,kBAAkB;QAC1E,CAAC,CAAC,OAAO,CAAC,sBAAsB;QAChC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;AAC9B,CAAC;AAGD,MAAM,UAAU,sBAAsB,CACpC,OAGC,EACD,MAAc,UAAU,EAAE;IAE1B,OAAO,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,kBAAkB;QAC1E,CAAC,CAAC,OAAO,CAAC,oBAAoB;QAC9B,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;AAC5B,CAAC;AAGD,MAAM,UAAU,yBAAyB,CACvC,OAGC,EACD,MAAc,UAAU,EAAE;IAE1B,OAAO,OAAO,CAAC,qBAAqB,KAAK,CAAC;QACxC,GAAG,IAAI,OAAO,CAAC,qBAAqB;QACpC,CAAC,CAAC,OAAO,CAAC,uBAAuB;QACjC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;AAC/B,CAAC;AA4CD,MAAM,UAAU,0BAA0B,CACxC,OAA8B,EAC9B,MAAc,UAAU,EAAE;IAE1B,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,IAAI,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,OAAO,CAAC,kBAAkB;YACvC,OAAO,EAAE,OAAO,CAAC,aAAa;YAC9B,OAAO,EAAE,OAAO,CAAC,oBAAoB;SACtC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,mBAAmB,KAAK,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,OAAO,CAAC,mBAAmB;YACxC,OAAO,EAAE,OAAO,CAAC,YAAY;YAC7B,OAAO,EAAE,OAAO,CAAC,mBAAmB;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,OAAO,CAAC,kBAAkB;YACvC,OAAO,EAAE,OAAO,CAAC,eAAe;YAChC,OAAO,EAAE,OAAO,CAAC,sBAAsB;SACxC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,OAAO,CAAC,kBAAkB;YACvC,OAAO,EAAE,OAAO,CAAC,aAAa;YAC9B,OAAO,EAAE,OAAO,CAAC,oBAAoB;SACtC,CAAC,CAAC;IACL,CAAC;IACD,IACE,OAAO,CAAC,qBAAqB,KAAK,CAAC;QACnC,GAAG,GAAG,OAAO,CAAC,qBAAqB,EACnC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,OAAO,CAAC,qBAAqB;YAC1C,OAAO,EAAE,OAAO,CAAC,gBAAgB;YACjC,OAAO,EAAE,OAAO,CAAC,uBAAuB;SACzC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAW,EACX,KAAgE;IAEhE,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,OAAO;QACL,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,qBAAqB;QACzD,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC;QAC/C,oBAAoB,EAAE,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC;QAC7D,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,gBAAgB,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACrD,uBAAuB,EAAE,YAAY,CAAC,IAAI,CAAC,uBAAuB,CAAC;QACnE,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,EAAE,OAAO;KACb,CAAC;AACJ,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,KAAgE,EAChE,MAAc,UAAU,EAAE;IAE1B,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjD,0BAA0B,CAAC,GAAG,EAAE,KAAK,CAAC;QACtC,mBAAmB,CAAC,KAAK,CAAC;KAC3B,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAC5B,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,OAAO;QACL,KAAK;QACL,MAAM;QACN,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,aAAa;QAC9B,cAAc,EAAE,OAAO,CAAC,oBAAoB;QAC5C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,gBAAgB,EAAE,OAAO;QACzB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/core/pda.d.ts

@@ -0,0 +1,29 @@
+import type { Address } from "@solana/kit";
+export interface PaymentAccountSeeds {
+    owner: Address;
+    mint: Address;
+    tokenProgram?: Address;
+}
+export declare function derivePaymentAccountAddress({ owner, mint, tokenProgram, }: PaymentAccountSeeds): Promise<Address>;
+export declare function derivePaymentAddress(input: {
+    paymentAccount: Address;
+    reference: Uint8Array;
+}): Promise<Address>;
+export declare function derivePaymentAddressFromSeeds(input: {
+    owner: Address;
+    mint: Address;
+    reference: Uint8Array;
+    tokenProgram?: Address;
+}): Promise<Address>;
+export declare function deriveMerchantOperatorAddress(input: {
+    treasury: Address;
+    operator: Address;
+}): Promise<Address>;
+export declare function deriveArbiterAddress(authority: Address): Promise<Address>;
+export declare function deriveEscrowAddress(seeds: PaymentAccountSeeds): Promise<Address>;
+export declare function deriveAssociatedTokenAddress(input: {
+    owner: Address;
+    mint: Address;
+    tokenProgram?: Address;
+}): Promise<Address>;
+//# sourceMappingURL=pda.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../src/core/pda.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAGD,wBAAsB,2BAA2B,CAAC,EAChD,KAAK,EACL,IAAI,EACJ,YAAoC,GACrC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxC;AAGD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,UAAU,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB;AAGD,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,UAAU,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnB;AAGD,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnB;AAGD,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/E;AAGD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAGD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB"}

package/dist/core/pda.js

@@ -0,0 +1,48 @@
+import { findAssociatedTokenPda, TOKEN_PROGRAM_ADDRESS, } from "@solana-program/token";
+import { findArbiterAccountPda } from "../generated/pdas/arbiterAccount.js";
+import { findMerchantOperatorPda } from "../generated/pdas/merchantOperator.js";
+import { findPaymentPda } from "../generated/pdas/payment.js";
+import { findPaymentAccountPda } from "../generated/pdas/paymentAccount.js";
+import { assertValidReference } from "./challenge.js";
+export async function derivePaymentAccountAddress({ owner, mint, tokenProgram = TOKEN_PROGRAM_ADDRESS, }) {
+    const [address] = await findPaymentAccountPda({ owner, tokenProgram, mint });
+    return address;
+}
+export async function derivePaymentAddress(input) {
+    assertValidReference(input.reference);
+    const [address] = await findPaymentPda({
+        paymentAccount: input.paymentAccount,
+        reference: input.reference,
+    });
+    return address;
+}
+export async function derivePaymentAddressFromSeeds(input) {
+    const paymentAccount = await derivePaymentAccountAddress(input);
+    return derivePaymentAddress({ paymentAccount, reference: input.reference });
+}
+export async function deriveMerchantOperatorAddress(input) {
+    const [address] = await findMerchantOperatorPda(input);
+    return address;
+}
+export async function deriveArbiterAddress(authority) {
+    const [address] = await findArbiterAccountPda({ authority });
+    return address;
+}
+export async function deriveEscrowAddress(seeds) {
+    const paymentAccount = await derivePaymentAccountAddress(seeds);
+    const [address] = await findAssociatedTokenPda({
+        owner: paymentAccount,
+        mint: seeds.mint,
+        tokenProgram: seeds.tokenProgram ?? TOKEN_PROGRAM_ADDRESS,
+    });
+    return address;
+}
+export async function deriveAssociatedTokenAddress(input) {
+    const [address] = await findAssociatedTokenPda({
+        owner: input.owner,
+        mint: input.mint,
+        tokenProgram: input.tokenProgram ?? TOKEN_PROGRAM_ADDRESS,
+    });
+    return address;
+}
+//# sourceMappingURL=pda.js.map

package/dist/core/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../../src/core/pda.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStD,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,EAChD,KAAK,EACL,IAAI,EACJ,YAAY,GAAG,qBAAqB,GAChB;IACpB,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,qBAAqB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAG1C;IACC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,cAAc,CAAC;QACrC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,KAKnD;IACC,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,oBAAoB,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;AAC9E,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,KAGnD;IACC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAAkB;IAC3D,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,qBAAqB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA0B;IAE1B,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC;QAC7C,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,qBAAqB;KAC1D,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAIlD;IACC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC;QAC7C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,qBAAqB;KAC1D,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/provider-fee-payer.d.ts

@@ -0,0 +1,5 @@
+import { type TransactionPartialSigner } from "@solana/kit";
+import type { ProviderTransport } from "./provider-transport.js";
+export type ProviderFeePayerSigner = TransactionPartialSigner;
+export declare function createProviderFeePayerSigner(transport: ProviderTransport): Promise<ProviderFeePayerSigner>;
+//# sourceMappingURL=provider-fee-payer.d.ts.map

package/dist/core/provider-fee-payer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fee-payer.d.ts","sourceRoot":"","sources":["../../src/core/provider-fee-payer.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,wBAAwB,EAG9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAM9D,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/core/provider-fee-payer.js

@@ -0,0 +1,17 @@
+import { getBase64EncodedWireTransaction, } from "@solana/kit";
+export async function createProviderFeePayerSigner(transport) {
+    const address = await transport.getFeePayerAddress();
+    return {
+        address,
+        async signTransactions(transactions) {
+            return Promise.all(transactions.map(async (transaction) => {
+                const wire = getBase64EncodedWireTransaction(transaction);
+                const signature = await transport.signAsFeePayer(wire);
+                return {
+                    [address]: signature,
+                };
+            }));
+        },
+    };
+}
+//# sourceMappingURL=provider-fee-payer.js.map

package/dist/core/provider-fee-payer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fee-payer.js","sourceRoot":"","sources":["../../src/core/provider-fee-payer.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,+BAA+B,GAOhC,MAAM,aAAa,CAAC;AASrB,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,SAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACrD,OAAO;QACL,OAAO;QACP,KAAK,CAAC,gBAAgB,CACpB,YAE4B;YAE5B,OAAO,OAAO,CAAC,GAAG,CAChB,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;gBACrC,MAAM,IAAI,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;gBAC1D,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACvD,OAAO;oBACL,CAAC,OAAO,CAAC,EAAE,SAA2B;iBACJ,CAAC;YACvC,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}