gondi 0.36.0 → 0.37.0

package/dist/src/blockchain.d.ts

@@ -58,8 +58,18 @@ export declare const zeroAddress: Address;
 export declare const zeroHash: Hash;
 export declare const zeroHex: HexString;
 export declare const REORG_SAFETY_BUFFER: bigint;
+/** Native ETH marker on Ethereum mainnet: the zero address. */
 export declare const __ETH_ADDRESS: `0x${string}`;
+/** Synthetic sentinel the Gondi API uses for native HYPE on HyperEVM. */
 export declare const __HYPE_ADDRESS = "0x0000000000000000000000000000000000000999";
+/** Synthetic sentinel the Gondi API uses for native ETH on the Robinhood chain. */
 export declare const __RETH_ADDRESS = "0x0000000000000000000000000000000000004663";
+/**
+ * Whether a currency address returned by the Gondi API represents a chain's native currency.
+ *
+ * The zero address only marks native ETH on Ethereum; HyperEVM and Robinhood orders carry the
+ * synthetic sentinels above instead, so never compare a currency address against the zero
+ * address to decide native-ness.
+ */
 export declare const isNativeCurrency: (address: Address) => boolean;
 export {};

package/dist/src/gondi.d.ts

@@ -4,7 +4,6 @@ import { Account, Address, Hash, Hex, TransactionReceipt } from 'viem';
 import { Auction } from './blockchain';
 import { Api, Props as ApiProps } from './clients/api';
 import { Contracts, GondiPublicClient, Wallet } from './clients/contracts';
-import { Opensea } from './clients/opensea';
 import { CollectionOrderInput, DealInput, MarketplaceEnum, NftOrderInput, SingleNftOrderInput, SingleNftSignedOfferInput, TokenStandardType, TraitOrderInput } from './generated/graphql';
 import * as model from './model';
 import { NftStandard } from './model';
@@ -20,7 +19,6 @@ interface GondiProps {
      */
     publicClient?: GondiPublicClient;
     apiClient?: ApiProps['apiClient'];
-    openseaApiKey?: string;
     onStepChange?: OnStepChange;
 }
 type Step = {
@@ -45,8 +43,7 @@ export declare class Gondi {
     account: Account;
     bcClient: GondiPublicClient;
     apiClient: Api;
-    openseaClient: Opensea;
-    constructor({ wallet, publicClient, apiClient, openseaApiKey, onStepChange }: GondiProps);
+    constructor({ wallet, publicClient, apiClient, onStepChange }: GondiProps);
     static create(props: GondiProps & {
         onStepChange: OnStepChange;
     }): Gondi;
@@ -3153,9 +3150,19 @@ export declare class Gondi {
         txHash: `0x${string}`;
         waitTxInBlock: () => Promise<TransactionReceipt>;
     }>;
+    /**
+     * Sells `nft` into `order`, a Native or OpenSea bid. The Gondi API builds the
+     * sale calldata for both marketplaces, so OpenSea bids need no client-side
+     * OpenSea credentials and no approval beyond the collateral's.
+     */
     sellNft({ order, nft, }: {
         order: {
             id: string;
+            /**
+             * The order's currency as reported by the Gondi API. A native-currency order carries the
+             * zero address on Ethereum, but a synthetic sentinel on other chains (`__HYPE_ADDRESS` on
+             * HyperEVM, `__RETH_ADDRESS` on Robinhood) — check it with `isNativeCurrency`.
+             */
             currencyAddress: Address;
             originalId: string;
             marketPlace: string;

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

@@ -0,0 +1,22 @@
+type TypedDataField = {
+    name: string;
+    type: string;
+};
+type TypedDataTypes = Record<string, readonly TypedDataField[]>;
+/**
+ * Returns the sign typed data parameters with the message reduced to the fields declared in
+ * `types`, recursing into nested structs and arrays.
+ *
+ * Extra properties do not change the EIP-712 hash, but they are serialized into the
+ * `eth_signTypedData_v4` request, so wallets display them and wallet security checks scan them:
+ * Rabby warns that "the transaction is not associated with the website that initiated it" when a
+ * URL anywhere in the payload does not match the connected site. Structs assembled by spreading
+ * API objects (offers carrying nested NFT and collection data) must therefore be stripped before
+ * reaching the wallet.
+ */
+export declare const sanitizeTypedDataMessage: <const TParameters extends {
+    primaryType: string;
+    types: TypedDataTypes;
+    message: Record<string, unknown>;
+}>(parameters: TParameters) => TParameters;
+export {};