Ethereum NFT

Ethereum NFT sale events monitoring SDK with built-in Discord and Twitter notification.

npm install enft

• 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

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

(back to top)

Subscribe to NFT sales events by calling onItemSold method.

import { Auth, ENFT } from 'enft';

const 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.

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

(back to top)

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'
    }
});

(back to top)

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.

(back to top)

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.

(back to top)

• Opensea

• Looksrare

• X2Y2

• Gem

• Genie

• NFT Trader

• Sudoswap

• Blur

(back to top)

• ENFT SDK

• Live Demo Discord Server
• Murakami.Flowers Discord Server

(back to top)

• Uniswap
• Sudo Swap OTC

Any contributions are welcome!

(back to top)

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.

(back to top)

kenryu.eth - @kenryu42 - ken0ryu@gmail.com

(back to top)

Collections that using this bot.

Open a Pull Request to add your collection below.

(back to top)

This project is MIT licensed.

(back to top)