Releases · trader-xyz/nft-swap-sdk

05 Feb 21:38

johnrjj

v0.12.0

7984548

v0.12 - No approvals required when accepting offer for NFT

📢 tl;dr: No approvals required when a user accepts a bid on their NFT -- a first for NFT marketplaces and swaps! 📢

🤝 If a user receives a bid on their NFT, they can accept the bid without needing to approve the NFT for transfer/swap first.

Simply call fillBuyNftOrderWithoutApproval instead of fillSignedOrder with the Swap SDK.

This provides the most seamless UX for accepting NFT bids on Ethereum, no more two-step process, and saves users money. 🤑

More info here

Note: This only works on NFT Buy orders (e.g. maker offers to buy NFT, taker can fill [by selling their NFT], without approval)

Assets 2

05 Feb 06:03

johnrjj

v0.11.0

af5d9b5

v0.11 - Fee support (Royalties, rewards, etc)

Adds configurable fee support to NFT Swap SDK.

Fees unlock all sorts of use cases:

Monetize applications,
Royalties for creators or DAOs
Reward users
Send payouts to a contract that implements custom fee disbursement logic

🔥 Under 120k gas for a NFT swap with one fee, the cheapest on the EVM 🔥

Fees can be specified by:

interface Fee {
    recipient: string // The address to send the fee to
    amount: string // The amount (based in the same erc20Token) to charge for fee
    feeData?: string | undefined; // optional feeData callback
}

Important notes:

Buyer of the NFT pays the fee(s)
Fees are in addition to the erc20TokenAmount that the buyer is paying for the NFT itself
Can support multiple fees

const MAKER_ASSET: SwappableAsset = {
  type: 'ERC721',
  tokenAddress: TEST_NFT_CONTRACT_ADDRESS,
  tokenId: '11045',
};

const TAKER_ASSET: SwappableAsset = {
  type: 'ERC20',
  tokenAddress: USDC_TOKEN_ADDRESS,
  amount: '420000000000000', // 4200 USDC
};

const v4Erc721Order = nftSwap.buildOrder(
  MAKER_ASSET,
  TAKER_ASSET,
  MAKER_WALLET_ADDRESS,
  {
    fees: [
      {
        amount: '6900000000000', // 69 USDC fee
        recipient: '0xaaa1388cD71e88Ae3D8432f16bed3c603a58aD34', // your DAO treasury 
      },
    ],
  }
);

Docs here: https://0x.org/docs/guides/0x-v4-nft-features-overview#fees

Spec: For each Fee specified in an order, the buyer of the NFT will pay the fee recipient the given amount of ETH/ERC20 tokens. This is in addition to the erc20TokenAmount that the buyer is paying for the NFT itself. There is an optional callback for each fee:

Assets 2

05 Feb 05:30

johnrjj

v0.10.0

12f704a

v0.10 - Collection-based orders

Adds Collection-based orders to NFT Swap SDK. (Also can be used as 'floor-based' orders).

🔥 Under 105k gas 🔥

These orders can be filled using any NFT from a particular collection.

The SDK provides a simple API:

// Maker creates an order for any NFT from a collection (you can think of it as a 'bid')
// Specifically in this example, the maker will sell 1000 USDC for any NFT in the collection specified
const v4Erc721Order = nftSwap.buildCollectionBasedOrder(
  // Selling ERC20
  {
    type: "ERC20",
    tokenAddress: USDC_TOKEN_ADDRESS,
    amount: "100000000000000", // 1000 USDC
  },
  // Bidding on any NFT in the collection
  {
    tokenAddress: NFT_CONTRACT_ADDDRESS,
    type: "ERC721", // "ERC721" | "ERC1155"
  },
  makerWalletAddress // Maker wallet address
)

const signedOrder = await nftSwap.signOrder(v4Erc721Order)

// Later, taker can sell an NFT from the specified collection, filling the bid.
const fillTx = await nftSwap.fillSignedCollectionOrder(
  signedOrder,
  "11045" // Token ID from the collection to fill order with
)