Skip to main content

​
What You Can Build

With the deploy-drop feature, you can:
  • Deploy Custom NFT Contracts: Create ERC721 contracts with your own branding and configuration
  • Manage Asset Lifecycle: Upload images, create metadata, and lazy mint NFTs
  • Configure Drop Conditions: Set pricing, timing, and purchase limits
  • Control Visibility: Show or hide your drops from public marketplaces
  • Collect Creator Fees: Configure royalties and fee collection addresses

​
Complete Workflow

A typical NFT drop follows this sequence:
  1. Upload Image → Host your NFT artwork
  2. Deploy Contract → Create your custom ERC721 contract
  3. Lazy Mint → Prepare NFTs for sale without upfront gas costs
  4. Set Conditions → Configure pricing, timing, and limits
  5. Update Visibility → Control marketplace visibility

​
Authentication

All deploy-drop endpoints require a secret key for authentication. Include your project’s secret key in the Authorization header: 
Authorization: Bearer sk-your-secret-key
Your project wallet will be used to sign all transactions and pay gas fees.

​
Supported Networks

The deploy-drop feature supports deployment on:
  • Soneium (Chain ID: 1868) - Primary network
  • Additional networks available upon request

​
Integration Workflow

​
1. Upload Image

Upload your NFT artwork to get a hosted URL for metadata. Endpoint: POST /v1/project-wallet/deploy-drop/upload-image Parameters:
  • imageFile (file): Image file (max 10MB)
  • assetName (string): Name for your asset
Example: 
curl -X POST https://local-api.lootex.dev/v1/project-wallet/deploy-drop/upload-image \
  -H "Authorization: Bearer sk-your-secret-key" \
  -F "[email protected]" \
  -F "assetName=My Awesome NFT"

​
2. Deploy Contract

Create your custom ERC721 contract on the blockchain. Endpoint: POST /v1/project-wallet/deploy-drop/deploy-contract Parameters:
  • chainId (number): Network chain ID (e.g., 1868 for Soneium)
  • imageUrl (string): URL from the upload-image step
  • name (string): Contract name (e.g., “My Awesome Collection”)
  • symbol (string): Contract symbol (e.g., “MAC”)
  • isCreatorFee (boolean, optional): Enable creator fees
  • creatorFeeAddress (string, optional): Address to receive fees
Example: 
curl -X POST https://local-api.lootex.dev/v1/project-wallet/deploy-drop/deploy-contract \
  -H "Authorization: Bearer sk-your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 1868,
    "imageUrl": "https://lootex-dev.s3.us-east-1.amazonaws.com/your-image.png",
    "name": "My Awesome Collection",
    "symbol": "MAC",
    "isCreatorFee": true,
    "creatorFeeAddress": "0x1234567890123456789012345678901234567890"
  }'

​
3. Lazy Mint NFTs

Prepare NFTs for sale without paying upfront minting costs. Gas is only paid when users actually purchase. Endpoint: POST /v1/project-wallet/deploy-drop/lazy-mint Parameters:
  • chainId (number): Network chain ID
  • contractId (string): Contract ID from deploy step
  • assetName (string): NFT name
  • assetDescription (string, optional): NFT description
  • assetImageUrl (string): Image URL for this NFT
  • amount (number): Quantity to make available
Example: 
curl -X POST https://local-api.lootex.dev/v1/project-wallet/deploy-drop/lazy-mint \
  -H "Authorization: Bearer sk-your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 1868,
    "contractId": "28921269-8a81-4d72-a723-af29a1a0b32c",
    "assetName": "Legendary Badge #1",
    "assetDescription": "A rare badge with special powers",
    "assetImageUrl": "https://lootex-dev.s3.us-east-1.amazonaws.com/badge.png",
    "amount": 100
  }'

​
4. Set Drop Conditions

Configure pricing, timing, and purchase limits for your drop. Endpoint: POST /v1/project-wallet/deploy-drop/set-conditions Parameters:
  • chainId (number): Network chain ID
  • contractId (string): Contract ID
  • price (string): Price per NFT in ETH (e.g., “0.1”)
  • currencyAddress (string, optional): Custom token address (defaults to ETH)
  • amount (number): Total NFTs available for sale
  • startTime (string, optional): Start time in UTC (defaults to now)
  • endTime (string, optional): End time in UTC (defaults to 24h from now)
  • limitPerWallet (number, optional): Max NFTs per wallet
Example: 
curl -X POST https://local-api.lootex.dev/v1/project-wallet/deploy-drop/set-conditions \
  -H "Authorization: Bearer sk-your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 1868,
    "contractId": "28921269-8a81-4d72-a723-af29a1a0b32c",
    "price": "0.05",
    "amount": 100,
    "startTime": "2025-08-01T00:00:00Z",
    "endTime": "2025-08-31T23:59:59Z",
    "limitPerWallet": 5
  }'

​
5. Update Visibility

Control whether your drop appears on public marketplaces. Endpoint: POST /v1/project-wallet/deploy-drop/update-visibility Parameters:
  • contractId (string): Contract ID
  • isVisible (boolean): Show (true) or hide (false) from marketplaces
Example: 
curl -X POST https://local-api.lootex.dev/v1/project-wallet/deploy-drop/update-visibility \
  -H "Authorization: Bearer sk-your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "28921269-8a81-4d72-a723-af29a1a0b32c",
    "isVisible": true
  }'