@mallow-labs/exchange-art-sdk

Unofficial TypeScript client SDK for the Exchange Art Solana programs — Market, Offers, and AuctionV2. Bundles the on-chain IDLs and convenience clients for building marketplace integrations.

Built on Anchor v0.29.

Disclaimer

This is an unofficial, community-maintained SDK. It is not affiliated with, endorsed by, or sponsored by Exchange Art, its parent company, or any of its affiliates. The "Exchange Art" name and any associated marks are the property of their respective owners and are used here solely to identify the on-chain programs the SDK interacts with.

This SDK is built from publicly observable on-chain program data (IDLs) and is provided "AS IS" without warranty of any kind — see LICENSE. It interacts with on-chain financial software; users are solely responsible for reviewing the code, validating outputs, and accepting the risks of any transactions they construct or sign. The authors are not liable for any losses, damages, or claims arising from use of this SDK.

If you are a representative of Exchange Art and would like this package adjusted, renamed, or removed, please email [email protected].

Install

pnpm add @mallow-labs/exchange-art-sdk

Usage

import {
  ExchangeArt,
  ExchangeArtAuctionV2IDL,
  ExchangeArtMarketIDL,
  ExchangeArtOffersIDL,
  FEE_ACCOUNT_ADDRESS,
  type ExchangeArtMetadata,
} from "@mallow-labs/exchange-art-sdk";

// Marketplace fee account
console.log(FEE_ACCOUNT_ADDRESS);
// MFHHByMGfk84s3GZ8dZHaQQ3gbpQYc2NnQYPg2tRCSx

// IDLs ready to feed to Anchor `Program`
const idl = ExchangeArtAuctionV2IDL.IDL;

// Shape of historical sale state seen on Exchange Art listings
const metadata: ExchangeArtMetadata = {
  auctionSellingAgreement: { /* ... */ },
};

Exports

| Group | Symbols | |---|---| | Namespaces | ExchangeArt — convenience client wrappers around the three programs | | IDLs | ExchangeArtAuctionV2IDL, ExchangeArtMarketIDL, ExchangeArtOffersIDL | | Constants | FEE_ACCOUNT_ADDRESS, FEE_ACCOUNT_KEY | | Types | ExchangeArtMetadata, AuctionSellingAgreement, EditionSellingAgreement, BuyNowSellingAgreement, WalletMintingState, FixedPriceEditionSaleState |

License

MIT. See LICENSE.

No warranty is provided. See the Disclaimer above for limits of liability and trademark attribution.