drops-market

CLI for the DROPS NFT marketplace on XRPL EVM. Create, mint, upload, and trade NFTs from the command line.

Agent-friendly: all commands support --json for structured output.

Install

npm install -g drops-market

Setup

export WALLET_PRIVATE_KEY=0x...   # EVM private key (also used for Arweave uploads)
drops status                       # Verify connection

Generate a new wallet: drops wallet new

Quick Reference

Create a Collection

# With image upload (Mode B)
drops create collection --name "My Art" --symbol "ART" --price 1 --supply 100 --royalty 5 --image ./banner.png

# With pre-uploaded URI (Mode A)
drops create collection --name "My Art" --symbol "ART" --price 1 --supply 100 --contract-uri "https://arweave.net/abc"

Create a Drop (batch, large supply)

drops create drop --name "Genesis" --symbol "GEN" --supply 1000 --price 0.5 --royalty 5 --images ./images/ --max-per-wallet 5

This uploads all images to Arweave, builds metadata, deploys the contract, and reveals in one command.

Mint

# Upload + mint in one step
drops mint 0xCollectionAddress --image ./art.png --name "Piece #1" --description "My first NFT"

# With pre-uploaded metadata URI
drops mint 0xCollectionAddress --uri "https://arweave.net/xyz"

# Batch mint on a drop
drops mint-drop 0xDropAddress --quantity 5

Upload (standalone)

drops upload image ./photo.png          # Returns Arweave URI
drops upload metadata ./meta.json       # Upload metadata JSON
drops upload batch ./images/            # Upload dir + build manifest (returns baseURI)

Browse & Read

drops info 0xAddress                    # Collection/drop details
drops list                              # All collections on the platform
drops list --creator 0xAddress          # Filter by creator
drops tokens 0xCollection              # List tokens in a collection
drops browse                            # Active marketplace listings

Secondary Market

drops list-nft 0xCollection 1 10        # List token #1 for 10 XRP
drops buy 1                             # Buy listing #1
drops cancel-listing 1                  # Cancel your listing

Offers

drops offer 0xCollection 1 --amount 5 --duration 7d
drops accept-offer 1
drops cancel-offer 1

Auctions

drops auction create 0xCollection 1 --start-price 5 --reserve 20 --duration 3d
drops auction bid 1 --amount 25
drops auction settle 1
drops auction cancel 1

Creator Admin

drops admin open-mint 0xCollection      # Enable minting
drops admin close-mint 0xCollection     # Disable minting
drops admin set-price 0xCollection 2    # Update mint price to 2 XRP
drops admin reveal 0xDrop --base-uri "https://arweave.net/manifest/"
drops admin withdraw 0xCollection       # Withdraw earnings

Flags

| Flag | Description | |------|-------------| | --testnet | Use XRPL EVM testnet (default during beta) | | --mainnet | Use XRPL EVM mainnet | | --json | JSON output for agents/scripts |

Environment Variables

| Variable | Description | |----------|-------------| | WALLET_PRIVATE_KEY | EVM private key (required for write commands, also used for Arweave) | | DROPS_CHAIN | testnet or mainnet |

Contracts (Testnet)

| Contract | Address | |----------|---------| | DropsFactory | 0x917AA02C718EFbF0621FD72Dd39E70C074b6732d | | DropsMarket | 0x00844CaE1ecfd0b73356f6d9cB7A7e421EC9c7A8 | | DropsOffers | 0x825237077534e8B13EF7055182d74FeEb3044383 | | DropsAuction | 0xb5D697C249f219E9D47969bCcEbE7E6A65291ccA |

Fee Structure

• Deploy fee: 10 XRP per collection/drop
• Primary sale: 2.5% platform fee on mints
• Secondary sale: 1% platform fee + creator royalties (0-10%)

Image Uploads (Arweave)

The CLI uses your WALLET_PRIVATE_KEY to sign Arweave uploads via Turbo. Your EVM key works directly — no separate Arweave wallet needed. Upload costs are extremely low (~$0.001/image) and paid from your Turbo balance.

You can also skip CLI uploads entirely by providing --uri with a pre-uploaded Arweave (or any HTTPS) URL.

License

MIT