feat: NBA TopShot Plugin - list, buy, and manage NBA TopShot NFTs using Flow blockchain

[kamalbuilds]

Fixes #1

NBA TopShot Plugin for Eliza

Background

EthDenver 2025

What does this PR do?

This plugin enables trading NBA TopShot moments through Eliza. It provides functionality to list, buy, and manage NBA TopShot NFTs using Flow blockchain.

Features

• View owned TopShot moments
• List moments for sale
• Purchase moments from the marketplace
• Cancel sale listings
• View market prices and metadata

Installation

pnpm install @eliza/plugin-nba-topshot

Configuration

The plugin requires Flow network configuration:

import { TopShotPlugin } from '@eliza/plugin-nba-topshot';

const plugin = new TopShotPlugin({
  network: 'mainnet', // or 'testnet'
  accessNode: 'https://rest-mainnet.onflow.org',
  walletDiscovery: 'https://fcl-discovery.onflow.org/authn'
});

Usage

Initialize the Plugin

await plugin.initialize();

View Owned Moments

const moments = await plugin.getMoments('0x1234...'); // Flow address

List a Moment for Sale

await plugin.listMomentForSale(momentId, price);

Purchase a Moment

await plugin.purchaseMoment(momentId);

Cancel a Sale

await plugin.cancelSale(momentId);

Get Market Prices

// Get all listings
const listings = await plugin.getMarketPrices();

// Filter by set or play
const filteredListings = await plugin.getMarketPrices(setId, playId);

Dependencies

• Flow Client Library (FCL)
• NBA TopShot Smart Contracts
• Dapper Utility Coin (DUC) for transactions

Contract Addresses

The plugin uses the following Flow contract addresses:

• TopShot: 0x0b2a3299cc857e29
• TopShotMarketV3: 0xc1e4f4f4c4257510
• DapperUtilityCoin: 0x82ec283f88a62e65

What kind of change is this?

Testing

Where should a reviewer start?

Detailed testing steps

[btspoony]

1. The Plugin is not the standard plugin for Eliza.
2. Please check some sample code at https://github.com/fixes-world/plugin-flow-advanced/tree/main/src.

[kamalbuilds]

@SeanRobb

[btspoony]

Good job