gondi 0.48.0 → 0.50.0

package/dist/src/gondi.d.ts

@@ -5,11 +5,12 @@ 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, LoanOfferPublicationInput, MarketplaceEnum, NftOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
+import { CollectionOrderInput, DealInput, GenerateCollectionOfferHashMutation, LoanOfferPublicationInput, MarketplaceEnum, NftOrderInput, NftSetOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
 import * as model from './model';
 import { NftStandard } from './model';
 import { BuyWithLoanInput, BuyWithLoanQuote } from './utils/buyWithLoan';
 import { CreditPurchaseInput, CreditPurchaseQuote } from './utils/creditPurchase';
+import { LoanDelegation } from './utils/delegation';
 import { LoanToMslLoanType } from './utils/loan';
 import { OptionalNullable } from './utils/types';
 /** An offer any NFT of a set, a collection or the NFTs carrying some traits, can borrow against. */
@@ -280,7 +281,15 @@ export declare class Gondi {
         }>;
         saveOffer: (signedOffer: TOffer & MakeOfferSignedFields) => Promise<TSaved>;
     }): Promise<TSaved>;
-    makeOrder(orderInput: SingleNftOrderInput | CollectionOrderInput | TraitOrderInput): Promise<{
+    /**
+     * Publishes a bid or listing, signing the order when the API asks for it.
+     *
+     * The input picks the kind: `tokenId` for one NFT, `traitIds` for a trait bid,
+     * `nftIds` for a set bid that fills with any of the listed NFTs of
+     * `collectionId` (2 to 1,000), and `collectionId` alone for a collection bid.
+     * A trait, set or collection bid fills up to `maxExecutions` times.
+     */
+    makeOrder(orderInput: SingleNftOrderInput | CollectionOrderInput | TraitOrderInput | NftSetOrderInput): Promise<{
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         contractAddress: import("./generated/graphql").Scalars["Address"];
         currencyAddress: import("./generated/graphql").Scalars["Address"];
@@ -331,6 +340,24 @@ export declare class Gondi {
         id: string;
         status: string;
         marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        nftIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "MultipleTraitOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         contractAddress: import("./generated/graphql").Scalars["Address"];
@@ -382,6 +409,24 @@ export declare class Gondi {
         id: string;
         status: string;
         marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        nftIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "TraitOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         contractAddress: import("./generated/graphql").Scalars["Address"];
@@ -433,6 +478,93 @@ export declare class Gondi {
         id: string;
         status: string;
         marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        nftIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "SingleNFTOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        contractAddress: import("./generated/graphql").Scalars["Address"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        tokenId: import("./generated/graphql").Scalars["BigInt"];
+        __typename?: "SetBidOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "SetBidOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        traitIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        __typename?: "SetBidOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        nftIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "SetBidOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         contractAddress: import("./generated/graphql").Scalars["Address"];
@@ -484,6 +616,24 @@ export declare class Gondi {
         id: string;
         status: string;
         marketPlaceAddress: Address;
+    } | {
+        amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        collectionId: import("./generated/graphql").Scalars["Int"];
+        currencyAddress: import("./generated/graphql").Scalars["Address"];
+        expirationTime: import("./generated/graphql").Scalars["BigInt"];
+        fees?: import("./generated/graphql").InputMaybe<Array<import("./generated/graphql").OrderFee>>;
+        isAsk?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        maxExecutions?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        nftIds: Array<import("./generated/graphql").Scalars["Int"]>;
+        price?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
+        signature: import("./generated/graphql").InputMaybe<`0x${string}`>;
+        startTime: import("./generated/graphql").Scalars["BigInt"];
+        stealth?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Boolean"]>;
+        taker?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["Address"]>;
+        __typename?: "CollectionOrder";
+        id: string;
+        status: string;
+        marketPlaceAddress: Address;
     }>;
     makeOrders(orders: SingleNftOrderInput[]): Promise<{
         __typename?: "SingleNFTOrder";
@@ -2915,10 +3065,15 @@ export declare class Gondi {
     }>;
     /**
      * RevokeDelegationsAndEmitLoan should be used when token has been delegated without being revoked,
-     * and a new loan wants to be emitted, erasing the delegations provided as argument.
+     * and a new loan wants to be emitted, erasing the delegations provided as argument in the same
+     * transaction as the emit.
+     *
+     * @param delegations The token's delegations, as the API's `Delegation.delegateTo` and
+     * `Delegation.rights` report them: each `{ to, rights }` is revoked with every rights value it
+     * lists, and a bare address with the full-rights `zeroHash`.
      */
     revokeDelegationsAndEmitLoan({ delegations, emit, }: {
-        delegations: Address[];
+        delegations: readonly LoanDelegation[];
         emit: Parameters<Gondi['emitLoan']>[0];
     }): Promise<{
         txHash: `0x${string}`;

package/dist/src/index.d.ts

@@ -5,6 +5,7 @@ export type { OnStepChange } from './gondi';
 export type { CreditPurchaseInput, CreditPurchaseQuote } from './utils/creditPurchase';
 export type { CrossCurrencyRenegotiationInput, CrossCurrencyRenegotiationQuote, } from './clients/contracts/CrossCurrencyRenegotiation';
 export type * as Types from './model';
+export type { LoanDelegation } from './utils/delegation';
 export { FULFILLED, REJECTED } from './utils/promises';
 export type { BuyWithLoanInput, BuyWithLoanQuote } from './utils/buyWithLoan';
 export type { LoanOfferPublicationInput } from './generated/graphql';

package/dist/src/utils/delegation.d.ts

@@ -0,0 +1,21 @@
+import { Address, Hash } from 'viem';
+/**
+ * A delegation the loan contract holds for a token: its delegate and every rights value enabled
+ * for it, as the API's `Delegation.delegateTo` and `Delegation.rights` report them. A bare address
+ * stands for the delegate's full-rights (`zeroHash`) delegation.
+ */
+export type LoanDelegation = Address | {
+    to: Address;
+    rights: readonly Hash[];
+};
+/**
+ * One `revokeDelegate` call per (delegate, rights) pair of `delegations`.
+ *
+ * IMPLEMENTATION NOTE: the delegate.xyz registry keys each delegation by its rights, so a
+ * revocation names the exact value it removes, and revoking one that was never enabled is a no-op
+ * (https://docs.delegate.xyz/technical-documentation/delegate-registry/idelegateregistry.sol).
+ */
+export declare const delegationRevocations: (delegations: readonly LoanDelegation[]) => {
+    to: `0x${string}`;
+    rights: `0x${string}`;
+}[];

package/dist/tests/utils/gondiStub.d.ts

@@ -0,0 +1,61 @@
+export declare const SINGLE_NFT_OFFER_HASH: {
+    offer: {
+        offerHash: "0x0000000000000000000000000000000000000000000000000000000000000000";
+        offerId: bigint;
+        validators: never[];
+        fee: bigint;
+        collateralAddress: "0x0000000000000000000000000000000000000000";
+        nft: {
+            tokenId: bigint;
+        };
+    };
+};
+export declare const RENEGOTIATION_OFFER_HASH: {
+    offer: {
+        renegotiationId: bigint;
+        offerHash: "0x0000000000000000000000000000000000000000000000000000000000000000";
+        loanId: bigint;
+    };
+};
+export declare const RENEGOTIATION: {
+    loanId: string;
+    principalAmount: bigint;
+    feeAmount: bigint;
+    aprBps: bigint;
+    duration: bigint;
+    expirationTime: bigint;
+};
+/**
+ * Builds a `Gondi` without running its constructor, holding only `fields`.
+ */
+export declare const stubGondi: (fields: object) => import("../../src").Gondi & object;
+/**
+ * Builds a `Gondi` without running its constructor: empty pending-publication
+ * maps, a zero-address account and wallet, plus the test's own `contracts` and
+ * `apiClient` stubs.
+ */
+export declare const gondiWith: (overrides: {
+    contracts: object;
+    apiClient: object;
+}) => import("../../src").Gondi & object;
+/**
+ * The `nftFlaggedByContractAddressAndTokenId` response for an NFT that is not
+ * flagged and wraps nothing.
+ */
+export declare const notFlaggedNft: () => Promise<{
+    nft: unknown;
+}>;
+/**
+ * Builds the stubs for a test of the flagged-NFT check that runs before a
+ * loan is emitted: an `nftFlaggedByContractAddressAndTokenId` mock answering
+ * `notFlaggedNft`, and a `createGondi` factory wiring it next to `contracts`,
+ * with the check on unless `skipFlaggedNftCheck` is passed.
+ */
+export declare const flaggedNftCheckStub: (contracts: object) => {
+    nftFlaggedByContractAddressAndTokenId: import("bun:test").Mock<() => Promise<{
+        nft: unknown;
+    }>>;
+    createGondi: ({ skipFlaggedNftCheck }?: {
+        skipFlaggedNftCheck?: boolean | undefined;
+    }) => import("../../src").Gondi & object;
+};