@defuse-protocol/nearintents-mpp-sdk 0.0.0 → 0.1.1

package/dist/server/Charge.js

@@ -0,0 +1,404 @@
+import { Errors, Method, Store } from 'mppx';
+import { SettlementFailedError, SettlementTimeoutError, SettlementUnavailableError, } from '../Errors.js';
+import * as OneClick from '../internal/OneClick.js';
+import * as Methods from '../Methods.js';
+import * as Types from '../Types.js';
+/**
+ * Creates a `nearintents` charge method for usage on the server.
+ *
+ * Each 402 challenge carries a unique single-use 1Click deposit address as
+ * `recipient` (minted via a wet `EXACT_OUTPUT` quote and cached with early
+ * refresh so the challenge `expires` always precedes the quote deadline).
+ * Verification confirms the client's deposit by 1Click status observation,
+ * drives the swap to a terminal state, and issues the extended receipt on
+ * `SUCCESS`.
+ *
+ * @example
+ * ```ts
+ * import { Mppx } from 'mppx/server'
+ * import { nearintents } from '@defuse-protocol/nearintents-mpp-sdk/server'
+ *
+ * const mppx = Mppx.create({
+ *   secretKey: process.env.MPP_SECRET_KEY!,
+ *   methods: [
+ *     nearintents.charge({
+ *       originAsset: 'eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+ *       destinationAsset: 'near:mainnet/nep141:1720…33a1',
+ *       destinationRecipient: 'merchant.near',
+ *       refundTo: '0x2527D02599Ba641c19FEa793cD0F9a6e8457C317',
+ *       amountOut: '1000000',
+ *       oneClick: { jwt: process.env.ONE_CLICK_JWT },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export function charge(parameters) {
+    const { amountOut: defaultAmountOut, description, destinationAsset, destinationRecipient, externalId, oneClick = {}, originAsset, 
+    // Distribution-channel attribution: every 1Click swap minted by this
+    // payment method carries the "mpp" referral (mirrors the x402 gateway).
+    referral = 'mpp', refundTo, slippageTolerance = 100, } = parameters;
+    // Merchant observability: settlement progress is reported as structured
+    // events (the library never logs). A throwing handler must not affect
+    // payment processing.
+    const emit = (event) => {
+        try {
+            parameters.onEvent?.(event);
+        }
+        catch {
+            // Observer errors are the observer's problem.
+        }
+    };
+    // Fail fast on malformed merchant config (throws at construction time).
+    const originNetwork = Types.chainOf(originAsset);
+    const destinationNetwork = Types.chainOf(destinationAsset);
+    const expiresWindowMs = (parameters.expiresWindow ?? 300) * 1000;
+    const quoteDeadlineBufferMs = (parameters.quoteDeadlineBuffer ?? 900) * 1000;
+    const pollIntervalMs = parameters.pollInterval ?? 2000;
+    const store = Store.from((parameters.store ?? Store.memory()), { keyPrefix: parameters.storeKeyPrefix ?? '' });
+    // Token list is fetched lazily and re-fetched once on an unresolved asset
+    // (the list evolves); a persistent miss is a merchant-config error.
+    let assetMapPromise;
+    function getAssetMap(refresh = false) {
+        if (!assetMapPromise || refresh) {
+            assetMapPromise = OneClick.getTokens(oneClick)
+                .then((tokens) => OneClick.createAssetMap(tokens, oneClick))
+                .catch((error) => {
+                assetMapPromise = undefined;
+                throw error;
+            });
+        }
+        return assetMapPromise;
+    }
+    async function resolveAssetId(caip19Id) {
+        let assetId = (await getAssetMap()).toAssetId(caip19Id);
+        if (!assetId)
+            assetId = (await getAssetMap(true)).toAssetId(caip19Id);
+        if (!assetId)
+            throw new Error(`nearintents-mpp-sdk: asset "${caip19Id}" is not on the 1Click token list — check the merchant configuration (or extend oneClick.networks).`);
+        return assetId;
+    }
+    const depositKey = (address) => `nearintents-mpp-sdk:deposit:${address}`;
+    const quoteKey = (identity) => `nearintents-mpp-sdk:quote:${identity}`;
+    const hashKey = (hash) => `nearintents-mpp-sdk:hash:${hash.toLowerCase()}`;
+    function identityOf(amountOut) {
+        return [
+            originAsset,
+            destinationAsset,
+            amountOut,
+            destinationRecipient,
+            refundTo,
+            slippageTolerance,
+            referral,
+        ].join('|');
+    }
+    /**
+     * Returns the route's active canonical request, minting a fresh 1Click
+     * quote when there is none — or when the cached one is stale (early
+     * refresh: a quote is stale once `now + expiresWindow > quote deadline`,
+     * so the challenge `expires` always precedes the active quote's deadline).
+     */
+    async function resolveActiveRequest(amountOut) {
+        const identity = identityOf(amountOut);
+        const pointer = await store.get(quoteKey(identity));
+        if (pointer && pointer.identity === identity) {
+            const deposit = await store.get(depositKey(pointer.depositAddress));
+            if (deposit &&
+                deposit.state === 'active' &&
+                deposit.identity === identity &&
+                Date.parse(deposit.deadline) > Date.now() + expiresWindowMs) {
+                emit({ type: 'quote.reused', depositAddress: deposit.request.recipient });
+                return deposit.request;
+            }
+        }
+        const [originAssetId, destinationAssetId] = await Promise.all([
+            resolveAssetId(originAsset),
+            resolveAssetId(destinationAsset),
+        ]);
+        const requestedDeadline = new Date(Date.now() + expiresWindowMs + quoteDeadlineBufferMs).toISOString();
+        const { quote } = await OneClick.quote(oneClick, {
+            originAsset: originAssetId,
+            destinationAsset: destinationAssetId,
+            amountOut,
+            recipient: destinationRecipient,
+            refundTo,
+            slippageTolerance,
+            deadline: requestedDeadline,
+            referral,
+        });
+        // Spec §Expiry: `expires` MUST be at or before the quote deadline. The
+        // backend's deadline is authoritative; if it cannot cover the route's
+        // static expires window, the route is misconfigured — fail loud.
+        if (Date.parse(quote.deadline) <= Date.now() + expiresWindowMs)
+            throw new Error(`nearintents-mpp-sdk: 1Click quote deadline (${quote.deadline}) does not cover the route's expires window (${expiresWindowMs / 1000}s) — lower expiresWindow or raise quoteDeadlineBuffer.`);
+        const request = {
+            amount: quote.amountIn,
+            currency: originAsset,
+            recipient: quote.depositAddress,
+            ...(description !== undefined && { description }),
+            ...(externalId !== undefined && { externalId }),
+            methodDetails: {
+                originNetwork,
+                destinationNetwork,
+                destinationAsset,
+                destinationRecipient,
+                amountOut,
+                minAmountIn: quote.minAmountIn,
+                depositMemo: quote.depositMemo ?? null,
+                slippageTolerance,
+                timeEstimate: quote.timeEstimate,
+                refundTo,
+                settlementBackend: Types.settlementBackend,
+                credentialTypes: [...Types.credentialTypes],
+            },
+        };
+        await store.put(depositKey(quote.depositAddress), {
+            identity,
+            request,
+            deadline: quote.deadline,
+            timeEstimate: quote.timeEstimate,
+            depositMemo: quote.depositMemo ?? null,
+            state: 'active',
+        });
+        await store.put(quoteKey(identity), { identity, depositAddress: quote.depositAddress });
+        emit({
+            type: 'quote.minted',
+            depositAddress: quote.depositAddress,
+            amountIn: quote.amountIn,
+            minAmountIn: quote.minAmountIn,
+            amountOut,
+            deadline: quote.deadline,
+            timeEstimate: quote.timeEstimate,
+        });
+        return request;
+    }
+    /** Marks a deposit spent and drops the cache pointer so the next 402 mints fresh. */
+    async function retireDeposit(depositAddress, identity) {
+        await store.update(depositKey(depositAddress), (current) => {
+            if (!current)
+                return { op: 'noop', result: undefined };
+            return { op: 'set', value: { ...current, state: 'settled' }, result: undefined };
+        });
+        await store.update(quoteKey(identity), (current) => {
+            if (current?.depositAddress !== depositAddress)
+                return { op: 'noop', result: undefined };
+            return { op: 'delete', result: undefined };
+        });
+    }
+    /** Atomically claims `hash` as in-flight. Expired leases are reclaimable. */
+    async function claimHash(hash, leaseUntil) {
+        return store.update(hashKey(hash), (current) => {
+            if (current?.state === 'consumed')
+                return { op: 'noop', result: 'consumed' };
+            if (current?.state === 'inflight' && current.leaseUntil > Date.now())
+                return { op: 'noop', result: 'inflight' };
+            return { op: 'set', value: { state: 'inflight', leaseUntil }, result: 'claimed' };
+        });
+    }
+    return Method.toServer(Methods.charge, {
+        // Valid canonical placeholder — replaced by the request hook on every
+        // real path; only the fallback challenge (request hook threw a
+        // PaymentError) ever serializes it.
+        defaults: {
+            amount: '0',
+            currency: originAsset,
+            recipient: 'unavailable',
+            ...(description !== undefined && { description }),
+            ...(externalId !== undefined && { externalId }),
+            methodDetails: {
+                originNetwork,
+                destinationNetwork,
+                destinationAsset,
+                destinationRecipient,
+                amountOut: defaultAmountOut ?? '0',
+                minAmountIn: '0',
+                depositMemo: null,
+                slippageTolerance,
+                refundTo,
+                settlementBackend: Types.settlementBackend,
+                credentialTypes: [...Types.credentialTypes],
+            },
+        },
+        // Spec §Challenge Binding: the deposit address, amount, and source asset
+        // are challenge-specific. Binding them means a rotated quote yields a
+        // binding mismatch → 402 with a fresh challenge (the client-recovery flow).
+        stableBinding(request) {
+            const { amount, currency, methodDetails, recipient } = request;
+            return { amount, currency, originNetwork: methodDetails.originNetwork, recipient };
+        },
+        async request({ credential, request }) {
+            const amountOut = request.methodDetails?.amountOut ??
+                defaultAmountOut;
+            if (!amountOut || amountOut === '0')
+                throw new Error('nearintents-mpp-sdk: amountOut is required — set it in charge({ amountOut }) or per route via methodDetails.amountOut.');
+            // Credential-bearing request: resolve the quote the challenge was
+            // minted from (store lookup keyed by deposit address) — never mint a
+            // quote for a credential. Note the echoed challenge is NOT yet
+            // HMAC-verified here; the lookup returns OUR stored request, so a
+            // forged recipient can at most cause a cache-limited quote refresh.
+            if (credential) {
+                const recipient = credential.challenge.request?.recipient;
+                if (typeof recipient === 'string' && recipient) {
+                    const deposit = await store.get(depositKey(recipient));
+                    if (deposit &&
+                        deposit.state === 'active' &&
+                        deposit.identity === identityOf(amountOut) &&
+                        Date.parse(deposit.deadline) > Date.now())
+                        return deposit.request;
+                }
+                // Unknown, spent, or expired deposit address: fall through to the
+                // current active quote. The stableBinding mismatch then yields a 402
+                // carrying this fresh challenge — the spec's client-recovery flow.
+            }
+            return resolveActiveRequest(amountOut);
+        },
+        async verify({ credential, request }) {
+            const { challenge } = credential;
+            const resolved = (() => {
+                const parsed = Methods.charge.schema.request.safeParse(request);
+                if (parsed.success)
+                    return parsed.data;
+                return request;
+            })();
+            const payload = credential.payload;
+            if (payload.type !== 'hash')
+                throw new Errors.InvalidPayloadError({ reason: 'only "hash" credentials are accepted' });
+            const hash = payload.hash;
+            // Spec §Verification step 4: the deposit address must correspond to an
+            // active, non-expired, non-settled quote in the server's state.
+            const recipient = resolved.recipient;
+            const deposit = await store.get(depositKey(recipient));
+            if (!deposit)
+                throw new Errors.InvalidChallengeError({
+                    id: challenge.id,
+                    reason: 'no active quote for this deposit address',
+                });
+            if (deposit.state === 'settled')
+                throw new Errors.InvalidChallengeError({
+                    id: challenge.id,
+                    reason: 'the quote for this deposit address is already settled',
+                });
+            if (Date.parse(deposit.deadline) <= Date.now())
+                throw new Errors.PaymentExpiredError({ expires: deposit.deadline });
+            const settlementTimeoutMs = (parameters.settlementTimeout ?? deposit.timeEstimate + 120) * 1000;
+            // Spec §Verification step 5 / §Replay: claim the hash in-flight
+            // atomically; consume permanently only on a terminal settlement state.
+            // The lease covers the settlement budget so a crashed settlement never
+            // strands a legitimate retry.
+            const claim = await claimHash(hash, Date.now() + settlementTimeoutMs + 60_000);
+            if (claim === 'consumed')
+                throw new Errors.VerificationFailedError({
+                    reason: 'transaction hash has already been used',
+                });
+            if (claim === 'inflight')
+                throw new Errors.VerificationFailedError({
+                    reason: 'settlement for this transaction hash is already in progress',
+                });
+            let hashOutcome = 'release';
+            try {
+                // Spec §Settlement step 1: notify the backend (optional accelerator;
+                // status observation below is authoritative, so failures are benign).
+                const accepted = await OneClick.submitDeposit(oneClick, {
+                    txHash: hash,
+                    depositAddress: recipient,
+                    ...(deposit.depositMemo !== null && { memo: deposit.depositMemo }),
+                }).then(() => true, () => false);
+                emit({ type: 'deposit.submitted', depositAddress: recipient, originTxHash: hash, accepted });
+                // Spec §Settlement step 2 + §Verification step 3: poll to a terminal
+                // status; the backend detecting a qualifying deposit at `recipient`
+                // IS the deposit confirmation (status-observation mode).
+                const status = await OneClick.pollToTerminal(oneClick, {
+                    depositAddress: recipient,
+                    ...(deposit.depositMemo !== null && { depositMemo: deposit.depositMemo }),
+                    timeoutMs: settlementTimeoutMs,
+                    intervalMs: pollIntervalMs,
+                    onStatus: (observed) => emit({ type: 'settlement.status', depositAddress: recipient, status: observed }),
+                });
+                // Any terminal state spends the quote and its deposit address —
+                // including SUCCESS whose observed deposits don't match the presented
+                // hash (below). Retiring here, before that match check, is deliberate:
+                // once the backend reaches SUCCESS the deposit is delivered, so the
+                // quote MUST leave rotation regardless of which credential presented
+                // it. Deferring the retire until after a match check would strand a
+                // backend-settled deposit as "active" in the store, and a later
+                // cache hit could hand a fresh payer an already-spent deposit address.
+                await retireDeposit(recipient, deposit.identity);
+                emit({
+                    type: 'settlement.terminal',
+                    depositAddress: recipient,
+                    originTxHash: hash,
+                    status: status.status,
+                    ...(OneClick.destinationTxHash(status) !== undefined && {
+                        destinationTxHash: OneClick.destinationTxHash(status),
+                    }),
+                });
+                if (status.status === 'SUCCESS') {
+                    // Deposit confirmation: the presented hash must be among the
+                    // origin-chain transactions the backend observed for this address.
+                    if (!OneClick.matchesOriginTx(status, hash))
+                        throw new Errors.VerificationFailedError({
+                            reason: 'the presented transaction hash is not among the deposits observed for this address',
+                        });
+                    hashOutcome = 'consume';
+                    const reference = OneClick.destinationTxHash(status) ?? status.swapDetails?.nearTxHashes?.[0];
+                    // The merchant has been paid at this point; a missing reference is
+                    // a backend anomaly worth failing loudly on (500), not a 402.
+                    if (!reference)
+                        throw new Error(`nearintents-mpp-sdk: swap for ${recipient} reached SUCCESS but reported no settlement transaction hash.`);
+                    const receipt = Types.toReceipt({
+                        challengeId: challenge.id,
+                        reference,
+                        originTxHash: hash,
+                        destinationNetwork: resolved.methodDetails.destinationNetwork,
+                        ...(resolved.externalId !== undefined && { externalId: resolved.externalId }),
+                    });
+                    emit({
+                        type: 'receipt.issued',
+                        challengeId: challenge.id,
+                        depositAddress: recipient,
+                        originTxHash: hash,
+                        reference,
+                    });
+                    return receipt;
+                }
+                // Non-success terminal (FAILED/REFUNDED/INCOMPLETE_DEPOSIT): the
+                // deposit is refunded to refundTo and the hash can never deliver —
+                // consume it. The client recovers with a fresh challenge.
+                hashOutcome = 'consume';
+                throw (OneClick.terminalError(status) ??
+                    new SettlementFailedError({ reason: `unexpected terminal status ${status.status}` }));
+            }
+            catch (error) {
+                // Backend unavailability / settlement timeout: 5xx, never
+                // verification-failed; do not settle, release the claim so the same
+                // credential can be re-presented.
+                if (error instanceof OneClick.OneClickUnavailableError) {
+                    emit({
+                        type: 'settlement.suspended',
+                        depositAddress: recipient,
+                        originTxHash: hash,
+                        reason: 'unavailable',
+                    });
+                    throw new SettlementUnavailableError({ reason: error.message });
+                }
+                if (error instanceof OneClick.PollTimeoutError) {
+                    emit({
+                        type: 'settlement.suspended',
+                        depositAddress: recipient,
+                        originTxHash: hash,
+                        reason: 'timeout',
+                    });
+                    throw new SettlementTimeoutError({ timeoutMs: settlementTimeoutMs });
+                }
+                throw error;
+            }
+            finally {
+                if (hashOutcome === 'consume')
+                    await store.put(hashKey(hash), { state: 'consumed' });
+                else
+                    await store.delete(hashKey(hash));
+            }
+        },
+    });
+}
+//# sourceMappingURL=Charge.js.map

package/dist/server/Charge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Charge.js","sourceRoot":"","sources":["../../src/server/Charge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAE5C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,MAAM,CAAC,UAA6B;IAClD,MAAM,EACJ,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,QAAQ,GAAG,EAAE,EACb,WAAW;IACX,qEAAqE;IACrE,wEAAwE;IACxE,QAAQ,GAAG,KAAK,EAChB,QAAQ,EACR,iBAAiB,GAAG,GAAG,GACxB,GAAG,UAAU,CAAA;IAEd,wEAAwE;IACxE,sEAAsE;IACtE,sBAAsB;IACtB,MAAM,IAAI,GAAG,CAAC,KAAmB,EAAQ,EAAE;QACzC,IAAI,CAAC;YACH,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC,CAAA;IAED,wEAAwE;IACxE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAChD,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE1D,MAAM,eAAe,GAAG,CAAC,UAAU,CAAC,aAAa,IAAI,GAAG,CAAC,GAAG,IAAI,CAAA;IAChE,MAAM,qBAAqB,GAAG,CAAC,UAAU,CAAC,mBAAmB,IAAI,GAAG,CAAC,GAAG,IAAI,CAAA;IAC5E,MAAM,cAAc,GAAG,UAAU,CAAC,YAAY,IAAI,IAAI,CAAA;IAEtD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,CAAC,UAAU,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAA2C,EAC9E,EAAE,SAAS,EAAE,UAAU,CAAC,cAAc,IAAI,EAAE,EAAE,CAC/C,CAAA;IAED,0EAA0E;IAC1E,oEAAoE;IACpE,IAAI,eAAuD,CAAA;IAC3D,SAAS,WAAW,CAAC,OAAO,GAAG,KAAK;QAClC,IAAI,CAAC,eAAe,IAAI,OAAO,EAAE,CAAC;YAChC,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;iBAC3C,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;iBAC3D,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,eAAe,GAAG,SAAS,CAAA;gBAC3B,MAAM,KAAK,CAAA;YACb,CAAC,CAAC,CAAA;QACN,CAAC;QACD,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,QAAgB;QAC5C,IAAI,OAAO,GAAG,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACvD,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACrE,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,qGAAqG,CAC7I,CAAA;QACH,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,+BAA+B,OAAO,EAAW,CAAA;IACzF,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,6BAA6B,QAAQ,EAAW,CAAA;IACvF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,4BAA4B,IAAI,CAAC,WAAW,EAAE,EAAW,CAAA;IAE3F,SAAS,UAAU,CAAC,SAAiB;QACnC,OAAO;YACL,WAAW;YACX,gBAAgB;YAChB,SAAS;YACT,oBAAoB;YACpB,QAAQ;YACR,iBAAiB;YACjB,QAAQ;SACT,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,UAAU,oBAAoB,CAAC,SAAiB;QACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;QAEtC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnD,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;YACnE,IACE,OAAO;gBACP,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAC1B,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,EAC3D,CAAC;gBACD,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;gBACzE,OAAO,OAAO,CAAC,OAAO,CAAA;YACxB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5D,cAAc,CAAC,WAAW,CAAC;YAC3B,cAAc,CAAC,gBAAgB,CAAC;SACjC,CAAC,CAAA;QAEF,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAChC,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,GAAG,qBAAqB,CACrD,CAAC,WAAW,EAAE,CAAA;QACf,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC/C,WAAW,EAAE,aAAa;YAC1B,gBAAgB,EAAE,kBAAkB;YACpC,SAAS;YACT,SAAS,EAAE,oBAAoB;YAC/B,QAAQ;YACR,iBAAiB;YACjB,QAAQ,EAAE,iBAAiB;YAC3B,QAAQ;SACT,CAAC,CAAA;QAEF,uEAAuE;QACvE,sEAAsE;QACtE,iEAAiE;QACjE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe;YAC5D,MAAM,IAAI,KAAK,CACb,+CAA+C,KAAK,CAAC,QAAQ,gDAAgD,eAAe,GAAG,IAAI,wDAAwD,CAC5L,CAAA;QAEH,MAAM,OAAO,GAAwB;YACnC,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,KAAK,CAAC,cAAc;YAC/B,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;YACjD,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;YAC/C,aAAa,EAAE;gBACb,aAAa;gBACb,kBAAkB;gBAClB,gBAAgB;gBAChB,oBAAoB;gBACpB,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;gBACtC,iBAAiB;gBACjB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,QAAQ;gBACR,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,eAAe,EAAE,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;aAC5C;SACF,CAAA;QAED,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE;YAChD,QAAQ;YACR,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAA;QACF,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAA;QAEvF,IAAI,CAAC;YACH,IAAI,EAAE,cAAc;YACpB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS;YACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAA;QAEF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,qFAAqF;IACrF,KAAK,UAAU,aAAa,CAAC,cAAsB,EAAE,QAAgB;QACnE,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;YACzD,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;YACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QAClF,CAAC,CAAC,CAAA;QACF,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;YACjD,IAAI,OAAO,EAAE,cAAc,KAAK,cAAc;gBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;YACxF,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QAC5C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IAC7E,KAAK,UAAU,SAAS,CACtB,IAAY,EACZ,UAAkB;QAElB,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;YAC7C,IAAI,OAAO,EAAE,KAAK,KAAK,UAAU;gBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;YAC5E,IAAI,OAAO,EAAE,KAAK,KAAK,UAAU,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE;gBAClE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;YAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACnF,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAyC,OAAO,CAAC,MAAM,EAAE;QAC7E,sEAAsE;QACtE,+DAA+D;QAC/D,oCAAoC;QACpC,QAAQ,EAAE;YACR,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,aAAa;YACxB,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;YACjD,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;YAC/C,aAAa,EAAE;gBACb,aAAa;gBACb,kBAAkB;gBAClB,gBAAgB;gBAChB,oBAAoB;gBACpB,SAAS,EAAE,gBAAgB,IAAI,GAAG;gBAClC,WAAW,EAAE,GAAG;gBAChB,WAAW,EAAE,IAAI;gBACjB,iBAAiB;gBACjB,QAAQ;gBACR,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,eAAe,EAAE,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;aAC5C;SACiB;QAEpB,yEAAyE;QACzE,sEAAsE;QACtE,4EAA4E;QAC5E,aAAa,CAAC,OAAO;YACnB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;YAC9D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE,SAAS,EAAE,CAAA;QACpF,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE;YACnC,MAAM,SAAS,GACZ,OAAO,CAAC,aAA0D,EAAE,SAAS;gBAC9E,gBAAgB,CAAA;YAClB,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,GAAG;gBACjC,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAA;YAEH,kEAAkE;YAClE,qEAAqE;YACrE,+DAA+D;YAC/D,kEAAkE;YAClE,oEAAoE;YACpE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,SAAS,GAAI,UAAU,CAAC,SAAS,CAAC,OAAwC,EAAE,SAAS,CAAA;gBAC3F,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,EAAE,CAAC;oBAC/C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;oBACtD,IACE,OAAO;wBACP,OAAO,CAAC,KAAK,KAAK,QAAQ;wBAC1B,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC,SAAS,CAAC;wBAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;wBAEzC,OAAO,OAAO,CAAC,OAAO,CAAA;gBAC1B,CAAC;gBACD,kEAAkE;gBAClE,qEAAqE;gBACrE,mEAAmE;YACrE,CAAC;YAED,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE;YAClC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAA;YAChC,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;gBACrB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;gBAC/D,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,MAAM,CAAC,IAAI,CAAA;gBACtC,OAAO,OAAyC,CAAA;YAClD,CAAC,CAAC,EAAE,CAAA;YAEJ,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAA;YAClC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBACzB,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC,CAAA;YAC1F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;YAEzB,uEAAuE;YACvE,gEAAgE;YAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;YACpC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;YACtD,IAAI,CAAC,OAAO;gBACV,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC;oBACrC,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,MAAM,EAAE,0CAA0C;iBACnD,CAAC,CAAA;YACJ,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAC7B,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC;oBACrC,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,MAAM,EAAE,uDAAuD;iBAChE,CAAC,CAAA;YACJ,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;YAErE,MAAM,mBAAmB,GACvB,CAAC,UAAU,CAAC,iBAAiB,IAAI,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,IAAI,CAAA;YAErE,gEAAgE;YAChE,uEAAuE;YACvE,uEAAuE;YACvE,8BAA8B;YAC9B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,mBAAmB,GAAG,MAAM,CAAC,CAAA;YAC9E,IAAI,KAAK,KAAK,UAAU;gBACtB,MAAM,IAAI,MAAM,CAAC,uBAAuB,CAAC;oBACvC,MAAM,EAAE,wCAAwC;iBACjD,CAAC,CAAA;YACJ,IAAI,KAAK,KAAK,UAAU;gBACtB,MAAM,IAAI,MAAM,CAAC,uBAAuB,CAAC;oBACvC,MAAM,EAAE,6DAA6D;iBACtE,CAAC,CAAA;YAEJ,IAAI,WAAW,GAA0B,SAAS,CAAA;YAClD,IAAI,CAAC;gBACH,qEAAqE;gBACrE,sEAAsE;gBACtE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE;oBACtD,MAAM,EAAE,IAAI;oBACZ,cAAc,EAAE,SAAS;oBACzB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;iBACnE,CAAC,CAAC,IAAI,CACL,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;gBACD,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAE5F,qEAAqE;gBACrE,oEAAoE;gBACpE,yDAAyD;gBACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE;oBACrD,cAAc,EAAE,SAAS;oBACzB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;oBACzE,SAAS,EAAE,mBAAmB;oBAC9B,UAAU,EAAE,cAAc;oBAC1B,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CACrB,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;iBACnF,CAAC,CAAA;gBAEF,gEAAgE;gBAChE,sEAAsE;gBACtE,uEAAuE;gBACvE,oEAAoE;gBACpE,qEAAqE;gBACrE,oEAAoE;gBACpE,gEAAgE;gBAChE,uEAAuE;gBACvE,MAAM,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAChD,IAAI,CAAC;oBACH,IAAI,EAAE,qBAAqB;oBAC3B,cAAc,EAAE,SAAS;oBACzB,YAAY,EAAE,IAAI;oBAClB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI;wBACtD,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC;qBACtD,CAAC;iBACH,CAAC,CAAA;gBAEF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAChC,6DAA6D;oBAC7D,mEAAmE;oBACnE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC;wBACzC,MAAM,IAAI,MAAM,CAAC,uBAAuB,CAAC;4BACvC,MAAM,EACJ,oFAAoF;yBACvF,CAAC,CAAA;oBACJ,WAAW,GAAG,SAAS,CAAA;oBACvB,MAAM,SAAS,GACb,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;oBAC7E,mEAAmE;oBACnE,8DAA8D;oBAC9D,IAAI,CAAC,SAAS;wBACZ,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,+DAA+D,CAC1G,CAAA;oBACH,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;wBAC9B,WAAW,EAAE,SAAS,CAAC,EAAE;wBACzB,SAAS;wBACT,YAAY,EAAE,IAAI;wBAClB,kBAAkB,EAAE,QAAQ,CAAC,aAAa,CAAC,kBAAkB;wBAC7D,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;qBAC9E,CAAC,CAAA;oBACF,IAAI,CAAC;wBACH,IAAI,EAAE,gBAAgB;wBACtB,WAAW,EAAE,SAAS,CAAC,EAAE;wBACzB,cAAc,EAAE,SAAS;wBACzB,YAAY,EAAE,IAAI;wBAClB,SAAS;qBACV,CAAC,CAAA;oBACF,OAAO,OAAO,CAAA;gBAChB,CAAC;gBAED,iEAAiE;gBACjE,mEAAmE;gBACnE,0DAA0D;gBAC1D,WAAW,GAAG,SAAS,CAAA;gBACvB,MAAM,CACJ,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC;oBAC9B,IAAI,qBAAqB,CAAC,EAAE,MAAM,EAAE,8BAA8B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CACrF,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0DAA0D;gBAC1D,oEAAoE;gBACpE,kCAAkC;gBAClC,IAAI,KAAK,YAAY,QAAQ,CAAC,wBAAwB,EAAE,CAAC;oBACvD,IAAI,CAAC;wBACH,IAAI,EAAE,sBAAsB;wBAC5B,cAAc,EAAE,SAAS;wBACzB,YAAY,EAAE,IAAI;wBAClB,MAAM,EAAE,aAAa;qBACtB,CAAC,CAAA;oBACF,MAAM,IAAI,0BAA0B,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;gBACjE,CAAC;gBACD,IAAI,KAAK,YAAY,QAAQ,CAAC,gBAAgB,EAAE,CAAC;oBAC/C,IAAI,CAAC;wBACH,IAAI,EAAE,sBAAsB;wBAC5B,cAAc,EAAE,SAAS;wBACzB,YAAY,EAAE,IAAI;wBAClB,MAAM,EAAE,SAAS;qBAClB,CAAC,CAAA;oBACF,MAAM,IAAI,sBAAsB,CAAC,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAA;gBACtE,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS;oBAAE,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;;oBAC/E,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACxC,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,5 @@
+export * as Errors from '../Errors.js';
+export * as Methods from '../Methods.js';
+export * as Types from '../Types.js';
+export * as nearintents from './Charge.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,WAAW,MAAM,aAAa,CAAA"}

package/dist/server/index.js

@@ -0,0 +1,5 @@
+export * as Errors from '../Errors.js';
+export * as Methods from '../Methods.js';
+export * as Types from '../Types.js';
+export * as nearintents from './Charge.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,WAAW,MAAM,aAAa,CAAA"}

package/package.json

@@ -1,12 +1,90 @@
 {
   "name": "@defuse-protocol/nearintents-mpp-sdk",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.1",
+  "description": "Reference implementation of the `nearintents` payment method for MPP (Machine Payments Protocol) — cross-chain HTTP 402 payments settled by NEAR Intents. Extends mppx.",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/defuse-protocol/nearintents-mpp-sdk.git"
+  },
+  "homepage": "https://github.com/defuse-protocol/nearintents-mpp-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/defuse-protocol/nearintents-mpp-sdk/issues"
+  },
+  "keywords": [
+    "mpp",
+    "machine-payments",
+    "http-402",
+    "payments",
+    "near",
+    "near-intents",
+    "cross-chain",
+    "typescript"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC"
-}
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "mppx": "0.8.13",
+    "viem": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "viem": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.4",
+    "@changesets/cli": "^2.31.1",
+    "@types/node": "^26.1.1",
+    "mppx": "0.8.13",
+    "tsx": "^4.23.1",
+    "typescript": "~6.0.3",
+    "viem": "^2.55.4",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "check": "pnpm check:types && pnpm lint && pnpm test",
+    "check:types": "tsc --noEmit",
+    "demo:app": "pnpm -C demo/app dev",
+    "demo:build": "pnpm -C demo/app install && pnpm -C demo/app build",
+    "demo:server": "tsx --env-file-if-exists=.env demo/server/index.ts",
+    "example:client": "tsx --env-file-if-exists=.env examples/client.ts",
+    "example:server": "tsx --env-file-if-exists=.env examples/server.ts",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "release": "pnpm build && changeset publish",
+    "test": "vitest run"
+  }
+}

package/src/Errors.ts

@@ -0,0 +1,86 @@
+import { Errors } from 'mppx'
+
+/**
+ * The deposit was verified but the cross-chain swap did not complete
+ * (1Click terminal status `FAILED` or `REFUNDED`). The deposit is refunded to
+ * `methodDetails.refundTo`; the client recovers with a fresh challenge.
+ *
+ * Additional error code registered by the `nearintents` spec (§Error Codes).
+ */
+export class SettlementFailedError extends Errors.PaymentError {
+  override readonly name = 'SettlementFailedError'
+  readonly title = 'Settlement Failed'
+  override readonly status: number = 402
+  readonly type = 'https://paymentauth.org/problems/settlement-failed'
+
+  constructor(options: SettlementFailedError.Options = {}) {
+    const { reason } = options
+    super(
+      reason
+        ? `Settlement failed: ${reason}.`
+        : 'Settlement failed: the cross-chain swap did not complete; the deposit is refunded to the refund address.',
+    )
+  }
+}
+
+export declare namespace SettlementFailedError {
+  type Options = {
+    /** Reason settlement failed (e.g. the 1Click refund reason). */
+    reason?: string | undefined
+  }
+}
+
+/**
+ * The 1Click backend was unreachable during a required check. Per the spec
+ * (§Verification), this MUST surface as an HTTP 5xx — never as
+ * `verification-failed` — and the credential MUST NOT be settled or consumed.
+ * The client retries the same credential once the backend recovers.
+ */
+export class SettlementUnavailableError extends Errors.PaymentError {
+  override readonly name = 'SettlementUnavailableError'
+  readonly title = 'Settlement Backend Unavailable'
+  override readonly status: number = 503
+  readonly type = 'https://paymentauth.org/problems/server-error'
+
+  constructor(options: SettlementUnavailableError.Options = {}) {
+    const { reason } = options
+    super(
+      reason
+        ? `Settlement backend unavailable: ${reason}.`
+        : 'Settlement backend unavailable; retry the same credential later.',
+    )
+  }
+}
+
+export declare namespace SettlementUnavailableError {
+  type Options = {
+    reason?: string | undefined
+  }
+}
+
+/**
+ * Settlement did not reach a terminal state within the server's time budget.
+ * The swap may still complete; the credential is NOT consumed, so the client
+ * can re-present the same credential later (or wait for the refund path).
+ */
+export class SettlementTimeoutError extends Errors.PaymentError {
+  override readonly name = 'SettlementTimeoutError'
+  readonly title = 'Settlement Timeout'
+  override readonly status: number = 504
+  readonly type = 'https://paymentauth.org/problems/server-error'
+
+  constructor(options: SettlementTimeoutError.Options = {}) {
+    const { timeoutMs } = options
+    super(
+      `Settlement did not reach a terminal state${
+        timeoutMs !== undefined ? ` within ${timeoutMs}ms` : ''
+      }; re-present the same credential later.`,
+    )
+  }
+}
+
+export declare namespace SettlementTimeoutError {
+  type Options = {
+    timeoutMs?: number | undefined
+  }
+}

package/src/Methods.ts

@@ -0,0 +1,24 @@
+import { Method } from 'mppx'
+
+import * as Types from './Types.js'
+
+/**
+ * NEAR Intents charge method — shared schema used by both server and client.
+ *
+ * The challenge `request` carries the origin-chain leg the client must pay
+ * (`recipient` is a unique single-use 1Click deposit address) plus the
+ * merchant's destination leg in `methodDetails`. The credential payload is
+ * the client's confirmed origin-chain deposit transaction hash (push mode).
+ *
+ * Spec: docs/spec/draft-nearintents-charge-00.md
+ */
+export const charge = Method.from({
+  name: Types.paymentMethod,
+  intent: Types.chargeIntent,
+  schema: {
+    credential: {
+      payload: Types.HashPayloadSchema,
+    },
+    request: Types.ChargeRequestSchema,
+  },
+})