@oasisprotocol/privana-sdk 0.5.0 → 0.5.2

package/dist/on-ramp.cjs

@@ -1,17 +1,17 @@
 "use client";
 'use strict';
 
-var chunkACLJPC75_cjs = require('./chunk-ACLJPC75.cjs');
+var chunkUHXVYWTF_cjs = require('./chunk-UHXVYWTF.cjs');
 
 
 
 Object.defineProperty(exports, "FiatOnRampForm", {
   enumerable: true,
-  get: function () { return chunkACLJPC75_cjs.FiatOnRampForm; }
+  get: function () { return chunkUHXVYWTF_cjs.FiatOnRampForm; }
 });
 Object.defineProperty(exports, "useFiatOnRamp", {
   enumerable: true,
-  get: function () { return chunkACLJPC75_cjs.useFiatOnRamp; }
+  get: function () { return chunkUHXVYWTF_cjs.useFiatOnRamp; }
 });
 //# sourceMappingURL=on-ramp.cjs.map
 //# sourceMappingURL=on-ramp.cjs.map

package/dist/on-ramp.d.cts

@@ -1,7 +1,8 @@
 import { MoonPayBuyWidget } from '@moonpay/moonpay-react';
-import { B as Bytes32, O as OnRampRecord, T as TokenConfig } from './on-ramp-XLXsy0aI.cjs';
-export { C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, g as OnRampStatus, P as PendingOnRampsResponse, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse } from './on-ramp-XLXsy0aI.cjs';
+import { B as Bytes32, _ as OnRampPostDepositLockConfig, d as TransactionSubmissionResponse, e as PostDepositLockError, $ as OnRampRecord, T as TokenConfig } from './pending-lock-BdkuMjmY.cjs';
+export { C as CreateOnRampIntentRequest, m as CreateOnRampIntentResponse, a0 as OnRampStatus, a3 as PendingOnRampsResponse, a7 as SignOnRampUrlRequest, a8 as SignOnRampUrlResponse, al as UpdateOnRampRequest, am as UpdateOnRampResponse } from './pending-lock-BdkuMjmY.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import 'viem';
 
 type MoonPayBuyProps = Parameters<typeof MoonPayBuyWidget>[0];
 type OnTransactionCompletedProps = Parameters<NonNullable<MoonPayBuyProps['onTransactionCompleted']>>[0];
@@ -24,8 +25,22 @@ interface FiatOnRampDebugEvent {
 interface UseFiatOnRampOptions {
     /** Privana token the on-ramp will deposit into. */
     tokenId: Bytes32;
+    /**
+     * Pre-sign a `Lock` for the buffered quote amount when the intent is
+     * created; the SDK submits it once the delivered deposit credits. Requires
+     * `prepareOnRampIntent` to be called with `quoteCurrencyAmount`.
+     */
+    postDepositLock?: OnRampPostDepositLockConfig;
     /** Fired when the deposit is credited inside the Privana accounting module. */
     onCredited?: (txHash: string) => void;
+    /** Fired when the pre-signed post-deposit lock is accepted by the API. */
+    onLockSubmitted?: (response: TransactionSubmissionResponse) => void;
+    /**
+     * Fired when the deposit credited but the pre-signed lock could not be
+     * submitted. The funds sit in the user's available balance — re-prompt a
+     * fresh lock signature at the credited amount. Falls back to `onError`.
+     */
+    onLockFailed?: (error: PostDepositLockError) => void;
     onError?: (error: Error) => void;
     /** Optional diagnostic event stream for previews/tests. No auth tokens or signatures are emitted. */
     onDebugEvent?: (event: FiatOnRampDebugEvent) => void;
@@ -84,6 +99,12 @@ interface UseFiatOnRampResult {
         currencyCode: string;
         baseCurrencyCode?: string;
         baseCurrencyAmount?: string;
+        /**
+         * Exact crypto amount (human units) the purchase targets — the same value
+         * passed to the widget as `quoteCurrencyAmount`. Required when
+         * `postDepositLock` is set: the signed lock amount derives from it.
+         */
+        quoteCurrencyAmount?: string;
     }) => Promise<OnRampRecord>;
     /** Wire to `<MoonPayBuyWidget onUrlSignatureRequested>`. */
     signUrl: (url: string) => Promise<string>;
@@ -136,6 +157,12 @@ interface FiatOnRampFormProps {
     baseCurrencyCode?: string;
     /** Pre-filled fiat amount the user can still edit in MoonPay (default: '100'). */
     defaultBaseCurrencyAmount?: string;
+    /**
+     * Exact crypto amount (human units) the purchase should deliver. Takes
+     * precedence over `defaultBaseCurrencyAmount` inside MoonPay. Required when
+     * `postDepositLock` is set.
+     */
+    quoteCurrencyAmount?: string;
     /** Override the display symbol. Defaults to the resolved token's symbol, then `currencyCode`. */
     tokenSymbol?: string;
     /** Enable dark mode or light mode as the default appearance for the widget. Possible values are dark, light. */
@@ -163,12 +190,21 @@ interface FiatOnRampFormProps {
     lockAmount?: boolean;
     /** Pre-selects a payment method tab in MoonPay */
     paymentMethod?: string;
+    /**
+     * Pre-sign a `Lock` for the buffered `quoteCurrencyAmount` before the
+     * purchase; the SDK submits it once the delivered deposit credits.
+     */
+    postDepositLock?: OnRampPostDepositLockConfig;
     /** Fired when the resulting Privana deposit is credited. */
     onCredited?: (depositTxHash: string) => void;
+    /** Fired when the pre-signed post-deposit lock is accepted by the API. */
+    onLockSubmitted?: (response: TransactionSubmissionResponse) => void;
+    /** Fired when the deposit credited but the pre-signed lock failed — re-prompt. */
+    onLockFailed?: (error: PostDepositLockError) => void;
     onError?: (error: Error) => void;
     /** Optional diagnostic event stream for previews/tests. */
     onDebugEvent?: (event: FiatOnRampDebugEvent) => void;
 }
-declare function FiatOnRampForm({ tokenId, currencyCode, baseCurrencyCode, defaultBaseCurrencyAmount, tokenSymbol, theme, themeId, colorCode, variant, autoStart, lockAmount, paymentMethod, onCredited, onError, onDebugEvent, }: FiatOnRampFormProps): react_jsx_runtime.JSX.Element;
+declare function FiatOnRampForm({ tokenId, currencyCode, baseCurrencyCode, defaultBaseCurrencyAmount, quoteCurrencyAmount, tokenSymbol, theme, themeId, colorCode, variant, autoStart, lockAmount, paymentMethod, postDepositLock, onCredited, onLockSubmitted, onLockFailed, onError, onDebugEvent, }: FiatOnRampFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FiatOnRampDebugEvent, FiatOnRampForm, type FiatOnRampFormProps, type FiatOnRampStatus, OnRampRecord, type UseFiatOnRampOptions, type UseFiatOnRampResult, useFiatOnRamp };
+export { type FiatOnRampDebugEvent, FiatOnRampForm, type FiatOnRampFormProps, type FiatOnRampStatus, OnRampPostDepositLockConfig, OnRampRecord, type UseFiatOnRampOptions, type UseFiatOnRampResult, useFiatOnRamp };

package/dist/on-ramp.d.ts

@@ -1,7 +1,8 @@
 import { MoonPayBuyWidget } from '@moonpay/moonpay-react';
-import { B as Bytes32, O as OnRampRecord, T as TokenConfig } from './on-ramp-XLXsy0aI.js';
-export { C as CreateOnRampIntentRequest, c as CreateOnRampIntentResponse, g as OnRampStatus, P as PendingOnRampsResponse, S as SignOnRampUrlRequest, b as SignOnRampUrlResponse, U as UpdateOnRampRequest, d as UpdateOnRampResponse } from './on-ramp-XLXsy0aI.js';
+import { B as Bytes32, _ as OnRampPostDepositLockConfig, d as TransactionSubmissionResponse, e as PostDepositLockError, $ as OnRampRecord, T as TokenConfig } from './pending-lock-BdkuMjmY.js';
+export { C as CreateOnRampIntentRequest, m as CreateOnRampIntentResponse, a0 as OnRampStatus, a3 as PendingOnRampsResponse, a7 as SignOnRampUrlRequest, a8 as SignOnRampUrlResponse, al as UpdateOnRampRequest, am as UpdateOnRampResponse } from './pending-lock-BdkuMjmY.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import 'viem';
 
 type MoonPayBuyProps = Parameters<typeof MoonPayBuyWidget>[0];
 type OnTransactionCompletedProps = Parameters<NonNullable<MoonPayBuyProps['onTransactionCompleted']>>[0];
@@ -24,8 +25,22 @@ interface FiatOnRampDebugEvent {
 interface UseFiatOnRampOptions {
     /** Privana token the on-ramp will deposit into. */
     tokenId: Bytes32;
+    /**
+     * Pre-sign a `Lock` for the buffered quote amount when the intent is
+     * created; the SDK submits it once the delivered deposit credits. Requires
+     * `prepareOnRampIntent` to be called with `quoteCurrencyAmount`.
+     */
+    postDepositLock?: OnRampPostDepositLockConfig;
     /** Fired when the deposit is credited inside the Privana accounting module. */
     onCredited?: (txHash: string) => void;
+    /** Fired when the pre-signed post-deposit lock is accepted by the API. */
+    onLockSubmitted?: (response: TransactionSubmissionResponse) => void;
+    /**
+     * Fired when the deposit credited but the pre-signed lock could not be
+     * submitted. The funds sit in the user's available balance — re-prompt a
+     * fresh lock signature at the credited amount. Falls back to `onError`.
+     */
+    onLockFailed?: (error: PostDepositLockError) => void;
     onError?: (error: Error) => void;
     /** Optional diagnostic event stream for previews/tests. No auth tokens or signatures are emitted. */
     onDebugEvent?: (event: FiatOnRampDebugEvent) => void;
@@ -84,6 +99,12 @@ interface UseFiatOnRampResult {
         currencyCode: string;
         baseCurrencyCode?: string;
         baseCurrencyAmount?: string;
+        /**
+         * Exact crypto amount (human units) the purchase targets — the same value
+         * passed to the widget as `quoteCurrencyAmount`. Required when
+         * `postDepositLock` is set: the signed lock amount derives from it.
+         */
+        quoteCurrencyAmount?: string;
     }) => Promise<OnRampRecord>;
     /** Wire to `<MoonPayBuyWidget onUrlSignatureRequested>`. */
     signUrl: (url: string) => Promise<string>;
@@ -136,6 +157,12 @@ interface FiatOnRampFormProps {
     baseCurrencyCode?: string;
     /** Pre-filled fiat amount the user can still edit in MoonPay (default: '100'). */
     defaultBaseCurrencyAmount?: string;
+    /**
+     * Exact crypto amount (human units) the purchase should deliver. Takes
+     * precedence over `defaultBaseCurrencyAmount` inside MoonPay. Required when
+     * `postDepositLock` is set.
+     */
+    quoteCurrencyAmount?: string;
     /** Override the display symbol. Defaults to the resolved token's symbol, then `currencyCode`. */
     tokenSymbol?: string;
     /** Enable dark mode or light mode as the default appearance for the widget. Possible values are dark, light. */
@@ -163,12 +190,21 @@ interface FiatOnRampFormProps {
     lockAmount?: boolean;
     /** Pre-selects a payment method tab in MoonPay */
     paymentMethod?: string;
+    /**
+     * Pre-sign a `Lock` for the buffered `quoteCurrencyAmount` before the
+     * purchase; the SDK submits it once the delivered deposit credits.
+     */
+    postDepositLock?: OnRampPostDepositLockConfig;
     /** Fired when the resulting Privana deposit is credited. */
     onCredited?: (depositTxHash: string) => void;
+    /** Fired when the pre-signed post-deposit lock is accepted by the API. */
+    onLockSubmitted?: (response: TransactionSubmissionResponse) => void;
+    /** Fired when the deposit credited but the pre-signed lock failed — re-prompt. */
+    onLockFailed?: (error: PostDepositLockError) => void;
     onError?: (error: Error) => void;
     /** Optional diagnostic event stream for previews/tests. */
     onDebugEvent?: (event: FiatOnRampDebugEvent) => void;
 }
-declare function FiatOnRampForm({ tokenId, currencyCode, baseCurrencyCode, defaultBaseCurrencyAmount, tokenSymbol, theme, themeId, colorCode, variant, autoStart, lockAmount, paymentMethod, onCredited, onError, onDebugEvent, }: FiatOnRampFormProps): react_jsx_runtime.JSX.Element;
+declare function FiatOnRampForm({ tokenId, currencyCode, baseCurrencyCode, defaultBaseCurrencyAmount, quoteCurrencyAmount, tokenSymbol, theme, themeId, colorCode, variant, autoStart, lockAmount, paymentMethod, postDepositLock, onCredited, onLockSubmitted, onLockFailed, onError, onDebugEvent, }: FiatOnRampFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FiatOnRampDebugEvent, FiatOnRampForm, type FiatOnRampFormProps, type FiatOnRampStatus, OnRampRecord, type UseFiatOnRampOptions, type UseFiatOnRampResult, useFiatOnRamp };
+export { type FiatOnRampDebugEvent, FiatOnRampForm, type FiatOnRampFormProps, type FiatOnRampStatus, OnRampPostDepositLockConfig, OnRampRecord, type UseFiatOnRampOptions, type UseFiatOnRampResult, useFiatOnRamp };

package/dist/on-ramp.js

@@ -1,4 +1,4 @@
 "use client";
-export { FiatOnRampForm, useFiatOnRamp } from './chunk-54FC6TO3.js';
+export { FiatOnRampForm, useFiatOnRamp } from './chunk-ZVUMV4NR.js';
 //# sourceMappingURL=on-ramp.js.map
 //# sourceMappingURL=on-ramp.js.map