gondi 0.43.1 → 0.45.0

package/dist/src/gondi.d.ts

@@ -5,7 +5,7 @@ import { Auction } from './blockchain';
 import { Api, Props as ApiProps } from './clients/api';
 import { Contracts, GondiPublicClient, Wallet } from './clients/contracts';
 import { CrossCurrencyRenegotiationInput, CrossCurrencyRenegotiationQuote } from './clients/contracts/CrossCurrencyRenegotiation';
-import { CollectionOrderInput, DealInput, GenerateCollectionOfferHashMutation, MarketplaceEnum, NftOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
+import { CollectionOrderInput, DealInput, GenerateCollectionOfferHashMutation, LoanOfferPublicationInput, MarketplaceEnum, NftOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
 import * as model from './model';
 import { NftStandard } from './model';
 import { BuyWithLoanInput, BuyWithLoanQuote } from './utils/buyWithLoan';
@@ -42,6 +42,14 @@ interface GondiProps {
     publicClient?: GondiPublicClient;
     apiClient?: ApiProps['apiClient'];
     onStepChange?: OnStepChange;
+    /**
+     * Skips the flagged-NFT lookup `emitLoan`, `revokeDelegationsAndEmitLoan`,
+     * `refinanceFromOffers`, `efficientRefinanceFromOffers` and
+     * `crossCurrencyRenegotiation` run before
+     * sending, saving an API call. Only for callers that already keep flagged
+     * NFTs out of those flows themselves, such as the GONDI web app.
+     */
+    skipFlaggedNftCheck?: boolean;
 }
 type Step = {
     type: 'signature';
@@ -60,12 +68,20 @@ type Step = {
 };
 export type OnStepChange = (step: Step) => Promise<void>;
 export declare class Gondi {
+    private pendingSingleNftPublications;
+    private pendingCollectionPublications;
+    private pendingRenegotiationPublications;
+    /** Retains bounded signed payloads while their API save is pending. */
+    private rememberPublication;
+    /** Binds signed terms and contract; excludes unsigned predecessors. */
+    private publicationKey;
     contracts: Contracts;
     wallet: Wallet;
     account: Account;
     bcClient: GondiPublicClient;
     apiClient: Api;
-    constructor({ wallet, publicClient, apiClient, onStepChange }: GondiProps);
+    skipFlaggedNftCheck: boolean;
+    constructor({ wallet, publicClient, apiClient, onStepChange, skipFlaggedNftCheck, }: GondiProps);
     static create(props: GondiProps & {
         onStepChange: OnStepChange;
     }): Gondi;
@@ -88,7 +104,13 @@ export declare class Gondi {
         nonce: string;
         issuedAt?: string;
     }) => string;
-    makeSingleNftOffer(offer: model.SingleNftOfferInput): Promise<{
+    /**
+     * Signs and saves an item offer.
+     * @param publication Optional unsigned admission metadata. Previews before signing
+     * and throws the backend rejection reason. Identical retries after failed saves
+     * reuse the signature; a successful save clears that pending signature.
+     */
+    makeSingleNftOffer(offer: model.SingleNftOfferInput, publication?: LoanOfferPublicationInput): Promise<{
         aprBps: import("./generated/graphql").Scalars["BigInt"];
         borrowerAddress: import("./generated/graphql").Scalars["Address"];
         capacity: import("./generated/graphql").Scalars["BigInt"];
@@ -114,10 +136,16 @@ export declare class Gondi {
         nftCollateralTokenId: bigint;
     }>;
     /** @internal */
-    _makeSingleNftOffer(offer: model.SingleNftOfferInput, mslContractAddress: Address, skipSave: true): Promise<SingleNftSignedOfferInput>;
+    _makeSingleNftOffer(offer: model.SingleNftOfferInput, mslContractAddress: Address, skipSave: true, publication?: LoanOfferPublicationInput): Promise<SingleNftSignedOfferInput>;
     /** @internal */
-    _makeSingleNftOffer(offer: model.SingleNftOfferInput, mslContractAddress?: Address, skipSave?: false): ReturnType<Api['saveSingleNftOffer']>;
-    makeCollectionOffer(offer: model.CollectionOfferInput): Promise<{
+    _makeSingleNftOffer(offer: model.SingleNftOfferInput, mslContractAddress?: Address, skipSave?: false, publication?: LoanOfferPublicationInput): ReturnType<Api['saveSingleNftOffer']>;
+    /**
+     * Signs and saves a collection offer without an item preview.
+     * @param publication Optional unsigned admission metadata. Identical retries after
+     * failed saves reuse the signature; a successful save clears that pending signature.
+     * The backend evaluates collection offers independently for each item.
+     */
+    makeCollectionOffer(offer: model.CollectionOfferInput, publication?: LoanOfferPublicationInput): Promise<{
         aprBps: import("./generated/graphql").Scalars["BigInt"];
         borrowerAddress: import("./generated/graphql").Scalars["Address"];
         capacity: import("./generated/graphql").Scalars["BigInt"];
@@ -143,7 +171,7 @@ export declare class Gondi {
         nftCollateralTokenId: bigint;
     }>;
     /** @internal */
-    _makeCollectionOffer(offer: model.CollectionOfferInput, mslContractAddress?: Address): Promise<{
+    _makeCollectionOffer(offer: model.CollectionOfferInput, mslContractAddress?: Address, publication?: LoanOfferPublicationInput): Promise<{
         aprBps: import("./generated/graphql").Scalars["BigInt"];
         borrowerAddress: import("./generated/graphql").Scalars["Address"];
         capacity: import("./generated/graphql").Scalars["BigInt"];
@@ -710,7 +738,13 @@ export declare class Gondi {
         id: bigint;
         contractAddress: Address;
     }): Promise<import("./generated/graphql").UnhideOfferMutation>;
-    makeRefinanceOffer({ renegotiation, contractAddress, ...props }: MakeRefinanceOfferProps): Promise<{
+    /**
+     * Signs and saves a refinance offer, optionally with a matching fallback.
+     * @param props.publication Optional unsigned admission metadata. Previews before
+     * signing and throws the backend rejection reason. Identical retries after failed
+     * saves reuse both signatures; a successful save clears the pending payloads.
+     */
+    makeRefinanceOffer({ renegotiation, contractAddress, publication, ...props }: MakeRefinanceOfferProps): Promise<{
         id: string;
         loanId: import("./generated/graphql").Scalars["String"];
         duration: import("./generated/graphql").Scalars["BigInt"];
@@ -875,6 +909,12 @@ export declare class Gondi {
         }>;
     }>;
     offerExecutionFromOffers(offers: OfferFromExecutionOffer[], amounts?: bigint[]): EmitLoanArgs['offerExecution'];
+    /**
+     * Throws `FlaggedNftError` when the API flags the collateral NFT or an NFT it wraps.
+     * An NFT the API does not know throws `NOT_FOUND`, and an API that does not answer
+     * throws its own error: a loan is only sent once the API confirms the NFT is not flagged.
+     */
+    private assertNftNotFlagged;
     emitLoan(args: EmitLoanArgs): Promise<{
         txHash: `0x${string}`;
         waitTxInBlock: () => Promise<{
@@ -3637,6 +3677,7 @@ export declare class Gondi {
 type MakeOfferType = Omit<Awaited<ReturnType<Gondi['makeSingleNftOffer']>>, 'nftId'> | Omit<Awaited<ReturnType<Gondi['makeCollectionOffer']>>, 'collectionId'> | Omit<Awaited<ReturnType<Gondi['makeTraitOffer']>>, 'traitIds'>;
 type OfferFromExecutionOffer = OptionalNullable<MakeOfferType, 'borrowerAddress' | 'lenderAddress' | 'offerHash' | 'signature'>;
 type MakeRefinanceOfferProps = {
+    publication?: LoanOfferPublicationInput;
     renegotiation: model.RenegotiationInput;
     contractAddress: Address;
 } & ({

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
+export { FlaggedNftError } from './errors';
 export { Gondi } from './gondi';
 export { LoanStatusType, OfferStatus, OffersSortField, Ordering, MarketplaceEnum, TokenStandardType, } from './generated/graphql';
 export type { OnStepChange } from './gondi';
@@ -6,3 +7,4 @@ export type { CrossCurrencyRenegotiationInput, CrossCurrencyRenegotiationQuote,
 export type * as Types from './model';
 export { FULFILLED, REJECTED } from './utils/promises';
 export type { BuyWithLoanInput, BuyWithLoanQuote } from './utils/buyWithLoan';
+export type { LoanOfferPublicationInput } from './generated/graphql';