Sound Protocol

Sound Protocol is a generalized platform for flexible and efficient creation of NFT drops.

Table of Contents

• Sound Protocol
  • Table of Contents
  • Deployments
  • Contracts
  • Documentation
  • Development
  • Deploying
  • Bug Bounty
  • License

Deployments

The following contracts have been deployed on Mainnet, Optimism, Goerli, Optimism-Goerli, and Sepolia.

Latest deployments

Older deployments

Architecture

The latest Sound Protocol comprises of several components:

• SoundEditionV2_1

  The NFT contract.

  An ERC721A contract deployed via the minimal proxy clone pattern.

  The mint function allows authorized minter contracts or administrators to batch mint NFTs
  (authorization is granted via the MINTER_ROLE or ADMIN_ROLE).

• SoundCreatorV2

  A factory that allows for a single transaction setup that:

  1. Clones and initializes a SoundEdition.
  2. Forwards calldata to an array of target contracts. These calldata can be used to set up the required authorizations and mint schedules.

• SuperMinterV2

  A generalized singleton minter contract that can mint on SoundEditions.

  Technically, any contract can be authorized to mint on a SoundEdition as long as they are granted the MINTER_ROLE.

• SoundMetadata

  A contract which is called by the SoundEdition in the tokenURI function for customizable metadata logic. The on-chain JSON variant is called SoundOnChainMetadata.

Contracts

The smart contracts are stored under the contracts directory.

These are the contracts currently used.

The actual directories may contain some older contracts not on the list ─ they are left there for backwards compatibility.

contracts
├── core
│   ├── SoundCreatorV2.sol ─ "Factory"
│   ├── SoundEditionV2_1.sol ─ "NFT implementation"
│   ├── interfaces
│   │   ├── ISoundCreatorV2.sol
│   │   └── ISoundEditionV2_1.sol
│   └── utils
│       ├── MintRandomnessLib.sol ─ "Library for on-chain 1-of-1 raffle"
│       ├── LibOps.sol ─ "Library for common operations"
│       └── ArweaveURILib.sol ─ "For efficient storage of Arweave URIs"
└── modules
    ├── SuperMinterV2.sol ─ "Generalized minter"
    ├── SoundMetadata.sol ─ "Metadata module for SoundEdition"
    ├── SoundOnChainMetadata.sol ─ "On-chain variant of SoundMetadata"
    ├── interfaces
    │   ├── ISuperMinterV2.sol
    │   ├── ISoundMetadata.sol
    │   └── ISoundOnChainMetadata.sol
    └── utils
        ├── DelegateCashLib.sol ─ "Library for querying DelegateCash"
        └── SoundOnChainMetadataLib.sol ─ "Library for SoundOnChainMetadata"

Documentation

The documentation for the latest contracts is under construction.

For now, you can refer to the Natspec.

Development

This is a foundry based project.

However, some of the directories differ from the defaults.

• The contracts are under contracts.
• The tests are under tests.

Deploying

The contracts have already been deployed to their canonical addresses.

If you need them on any other EVM based chain, please look into build_create2_deployments.sh.

Bug Bounty

Up to 10 ETH for any critical bugs that could result in loss of funds. Rewards will be given for smaller bugs or ideas.

License

MIT Copyright 2023 Sound.xyz