Table of Contents

Getting Started

Installation

npm install enft

Prerequisites

• Support Node.js version >= 18
• Alchemy API Key - apply here (Recommended)
• OR
• Infura NFT (Open Beta) API Key and API Key Secret - apply here
• fontconfig is also required for generating image with text. If your system doesn't have it, please install it first.

Ubuntu/Debian:

sudo apt-get install fontconfig

Fedora/RHEL/CentOS:

sudo yum install fontconfig

Arch Linux:

sudo pacman -S fontconfig

MacOS (Homebrew):

brew install fontconfig

Windows (Chocolatey):

choco install fontconfig

Optional

• Etherscan API Key for enabling ETH to USD conversion - apply here

Usage

Subscribe to NFT sales events by calling onItemSold method.

import { Auth, ENFT } from 'enft';

const auth = new Auth({
    alchemy: {
        apiKey: 'YOUR_ALCHEMY_API_KEY'
    }
});

const enft = new ENFT(auth);

enft.onItemSold({
    contractAddress: 'NFT_CONTRACT_ADDRESS',
    discordWebhook: 'DISCORD_WEBHOOK_URL', // optional
    etherscanApiKey: 'ETHERSCAN_API_KEY' // optional
});

To debug a specific transaction, call debugTransaction method.

enft.debugTransaction(
    {
        transactionHash: 'THE_TRANSACTION_HASH_TO_DEBUG',
        contractAddress: 'NFT_CONTRACT_ADDRESS',
        discordWebhook: 'DISCORD_WEBHOOK_URL' // optional
    },
    (txData) => {
        console.log(txData);
    }
);

For more concise example, please refer to Example.

Docs

See the auto-generated docs for more info on methods and parameters.

Built-in Notification

Notification is optional. You can enabling it by setting the coresponding argument when calling onItemSold method.

enft.onItemSold({
    discordWebhook: 'YOUR_DISCORD_WEBHOOK_URL',
    twitterConfig: {
        appKey: 'YOUR_TWITTER_APP_KEY',
        appSecret: 'YOUR_TWITTER_APP_SECRET',
        accessToken: 'YOUR_TWITTER_ACCESS_TOKEN',
        accessSecret: 'YOUR_TWITTER_ACCESS_SECRET'
    }
});

Twitter

1. Register Twitter developer account with Elevated access. 🔗 Link

2. Create a development app with OAuth 1.0a read-write permissions. 🔗 Link

3. Install Twurl and run following command:

   twurl authorize --consumer-key <your-app-key> --consumer-secret <your-app-secret>

   This will return an URL that you should open up in your browser. Authenticate to Twitter, and then enter the returned PIN back into the terminal.

   This should create a file called .twurlrc in your home directory with all the necessary information.

Discord

1. Open the Discord channel you want to receive sales event notifications.
2. From the channel menu, select Edit channel.
3. Select Integrations.
4. Select Create Webhook.
5. Enter the name of the bot that will post the message.
6. Copy the URL from the WEBHOOK URL field.
7. Click Save.

Market Coverage

• Opensea

• Looksrare

• X2Y2

• Gem

• Genie

• NFT Trader

• Sudoswap

• Blur

Live Demo

Twitter

• ENFT SDK

Discord

• Live Demo Discord Server
• Murakami.Flowers Discord Server

Unsupported Features

• [ ] Uniswap
• [ ] Sudo Swap OTC

Any contributions are welcome!

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

For more information on how to contribute, check out the contributing guide.

Contact

kenryu.eth - @kenryu42 - [email protected]

Collections

Collections that using this SDK.

Open a Pull Request to add your collection below.

| Collection | Twitter | Discord | | ---------------- | ----------------------------------------- | ------------------------------------------------------ | | Murakami.Flowers | @MFTMKKUS | Murakami.Flowers | | Rumble Kong League | @RumbleKongs | Rumble Kong League |

LICENSE

This project is MIT licensed.