Deploying

This guide covers deploying your magical-nft contracts to various networks.

Deployment Options

magical-nft provides several deployment scripts:

Script	Description
`DeployFull{{ProjectName}}.s.sol`	Deploy all contracts at once
`DeployOnly{{ProjectName}}.s.sol`	Deploy only the main contract
`DeployOnly{{ProjectName}}Renderer.s.sol`	Deploy only the renderer
`DeployOnly{{ProjectName}}Storage.s.sol`	Deploy only storage

anvil

forge script script/DeployFull{{ProjectName}}.s.sol \
  --rpc-url http://localhost:8545 \
  --broadcast

Make sure your .env file has the required values:

SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_KEY
PRIVATE_KEY=0x...
ETHERSCAN_API_KEY=...

source .env
 
forge script script/DeployFull{{ProjectName}}.s.sol \
  --rpc-url $SEPOLIA_RPC_URL \
  --broadcast \
  --verify

forge script script/DeployFull{{ProjectName}}.s.sol \
  --rpc-url $MAINNET_RPC_URL \
  --broadcast \
  --verify \
  --slow

The --slow flag helps avoid rate limiting during verification.

If automatic verification failed:

bun run verify

After deployment, upload your assets:

bun run upload-all-files

Save your deployed contract addresses in a safe place:

To upgrade the renderer without affecting existing tokens: