gondi 0.50.0 → 0.52.0

package/dist/src/gondi.d.ts

@@ -2,10 +2,10 @@ import { OperationVariables } from '@apollo/client/core/index.js';
 import { Maybe } from 'graphql/jsutils/Maybe';
 import { Account, Address, Hash, Hex, TransactionReceipt } from 'viem';
 import { Auction } from './blockchain';
-import { Api, Props as ApiProps } from './clients/api';
+import { Api, OrderInput, 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, NftSetOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
+import { DealInput, GenerateCollectionOfferHashMutation, LoanOfferPublicationInput, MarketplaceEnum, NftOrderInput, OfferValidatorInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType } from './generated/graphql';
 import * as model from './model';
 import { NftStandard } from './model';
 import { BuyWithLoanInput, BuyWithLoanQuote } from './utils/buyWithLoan';
@@ -286,10 +286,12 @@ export declare class Gondi {
      *
      * 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.
+     * `collectionId` (2 to 1,000), `condition.anyTraitIds` for an OR trait bid that
+     * fills with any NFT of `collectionId` carrying one of those values of a trait
+     * key, 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<{
+    makeOrder(orderInput: OrderInput): Promise<{
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         contractAddress: import("./generated/graphql").Scalars["Address"];
         currencyAddress: import("./generated/graphql").Scalars["Address"];
@@ -343,12 +345,13 @@ export declare class Gondi {
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         collectionId: import("./generated/graphql").Scalars["Int"];
+        condition?: import("./generated/graphql").InputMaybe<import("./generated/graphql").NftSetConditionInput>;
         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"]>;
+        nftIds?: import("./generated/graphql").InputMaybe<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"];
@@ -412,12 +415,13 @@ export declare class Gondi {
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         collectionId: import("./generated/graphql").Scalars["Int"];
+        condition?: import("./generated/graphql").InputMaybe<import("./generated/graphql").NftSetConditionInput>;
         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"]>;
+        nftIds?: import("./generated/graphql").InputMaybe<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"];
@@ -481,12 +485,13 @@ export declare class Gondi {
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         collectionId: import("./generated/graphql").Scalars["Int"];
+        condition?: import("./generated/graphql").InputMaybe<import("./generated/graphql").NftSetConditionInput>;
         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"]>;
+        nftIds?: import("./generated/graphql").InputMaybe<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"];
@@ -550,12 +555,13 @@ export declare class Gondi {
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         collectionId: import("./generated/graphql").Scalars["Int"];
+        condition?: import("./generated/graphql").InputMaybe<import("./generated/graphql").NftSetConditionInput>;
         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"]>;
+        nftIds?: import("./generated/graphql").InputMaybe<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"];
@@ -619,12 +625,13 @@ export declare class Gondi {
     } | {
         amount?: import("./generated/graphql").InputMaybe<import("./generated/graphql").Scalars["BigInt"]>;
         collectionId: import("./generated/graphql").Scalars["Int"];
+        condition?: import("./generated/graphql").InputMaybe<import("./generated/graphql").NftSetConditionInput>;
         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"]>;
+        nftIds?: import("./generated/graphql").InputMaybe<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"];
@@ -3894,6 +3901,45 @@ export declare class Gondi {
         txHash: `0x${string}`;
         waitMined: () => Promise<TransactionReceipt>;
     }>;
+    /**
+     * Where the wallet's CryptoPunk `tokenId` stands on its way into CryptoPunks 721, read from
+     * chain: `'wallet'` while the wallet holds it naked, `'stash'` once it sits in the wallet's
+     * Stash waiting for {@link wrapPunk721}, `'wrapped'` once the wallet holds its 721 token, and
+     * `'other'` when none of these holds.
+     *
+     * IMPLEMENTATION NOTE: the punks market's `punkIndexToAddress` names the punk's holder and
+     * `CryptoPunks721.punkProxyForUser` the wallet's Stash, deployed or not yet; a wrapped punk is
+     * held by the 721 contract, which mints its token to the wallet
+     * (https://721.cryptopunks.app, https://etherscan.io/address/0x000000000000003607fce1ac9e043a86675c5c2f#code).
+     */
+    punk721WrapState({ tokenId }: {
+        tokenId: bigint;
+    }): Promise<Punk721WrapState>;
+    /**
+     * Moves the wallet's naked CryptoPunk `tokenId` into its Stash, the first of the two
+     * transactions that wrap it into CryptoPunks 721. Refuses a punk the wallet does not hold.
+     */
+    transferPunkToStash721({ tokenId }: {
+        tokenId: bigint;
+    }): Promise<{
+        txHash: `0x${string}`;
+        waitTxInBlock: () => Promise<TransactionReceipt>;
+    }>;
+    /**
+     * Wraps the CryptoPunk `tokenId` waiting in the wallet's Stash into CryptoPunks 721, minting
+     * its 721 token to the wallet. Refuses a punk that is not in the Stash: move it there first
+     * with {@link transferPunkToStash721}.
+     */
+    wrapPunk721({ tokenId }: {
+        tokenId: bigint;
+    }): Promise<{
+        txHash: `0x${string}`;
+        waitTxInBlock: () => Promise<TransactionReceipt>;
+    }>;
+    /** The punk's wrap state with the addresses the wrap transactions need. */
+    private _punk721Holding;
+    /** A sent transaction whose `waitTxInBlock` resolves with its receipt once it succeeds. */
+    private _minedTransaction;
     buyWithSellAndRepay({ repaymentCalldata, purchaseBundlerAddress, mslContractAddress, price, swapData, }: {
         repaymentCalldata: Hex;
         purchaseBundlerAddress?: Address;
@@ -4022,6 +4068,8 @@ export type BurnAndWithdrawArgs = {
     erc1155Collections?: Address[];
     erc1155TokenIds?: bigint[];
 };
+/** Where a CryptoPunk stands on its way into CryptoPunks 721; see `Gondi.punk721WrapState`. */
+export type Punk721WrapState = 'wallet' | 'stash' | 'wrapped' | 'other';
 type wrapOldERC721Args = {
     collection: {
         contractData: {

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export { FlaggedNftError } from './errors';
 export { Gondi } from './gondi';
 export { LoanStatusType, OfferStatus, OffersSortField, Ordering, MarketplaceEnum, TokenStandardType, } from './generated/graphql';
-export type { OnStepChange } from './gondi';
+export type { OnStepChange, Punk721WrapState } from './gondi';
 export type { CreditPurchaseInput, CreditPurchaseQuote } from './utils/creditPurchase';
 export type { CrossCurrencyRenegotiationInput, CrossCurrencyRenegotiationQuote, } from './clients/contracts/CrossCurrencyRenegotiation';
 export type * as Types from './model';

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

@@ -25,6 +25,22 @@ export type CreditPurchaseQuote = Readonly<{
     loanSwapData: Hex;
     callbackData: Hex;
 }>;
+/** Decodes the purchase bundler's `executionInfo` callback carried by an execution or a seller repayment. */
+export declare const decodePurchaseCallback: (data: Hex) => {
+    reservoirExecutionInfo: {
+        module: `0x${string}`;
+        data: `0x${string}`;
+        value: bigint;
+    };
+    contractMustBeOwner: boolean;
+    purchaseCurrency: `0x${string}`;
+    amount: bigint;
+    swapData: `0x${string}`;
+    swapValue: bigint;
+    maxSlippage: bigint;
+};
+/** The callback's purchase currency, with every native spelling (including the ETH sentinel) as `zeroAddress`. */
+export declare const callbackPurchaseCurrency: (callback: ReturnType<typeof decodePurchaseCallback>) => Address;
 /** Compares every ABI field against the confirmed terms before signing or submitting an API execution. */
 export declare const assertCreditPurchaseExecution: (expected: ExecutionDataV7, received: unknown) => void;
 /** Rechecks activation, zero additional taxes and router funding before buyer signing. */