Skip to content

Commit 3253a53

Browse files
committed
added 7 new guides for contracts (#5467)
## Problem solved Short description of the bug fixed or feature added <!-- start pr-codex --> --- ## PR-Codex overview This PR focuses on restructuring and enhancing the documentation for various modular contract types in the `pre-built-modular` section, including updates to navigation, descriptions, and deployment steps. ### Detailed summary - Renamed `Pre-built Contracts` to `Pre-built Modular` in the sidebar. - Added detailed documentation for: - `NFT Drop` - `Token` - `Token Drop` - `Edition Drop` - `Open Edition` - `Edition` - `NFT Collection` - Included images and steps for deploying each contract type. - Updated links and metadata for better navigation and user experience. > ✨ Ask PR-Codex anything about this PR by commenting with `/codex {your question}` https://linear.app/thirdweb/issue/DEVX-1828/7-guides-for-contracts <!-- end pr-codex -->
1 parent 0e5d120 commit 3253a53

39 files changed

+648
-1
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
import { createMetadata, DocImage, Steps, Step, Callout, ContractDeployCard } from "@doc";
2+
import editionDropStep1 from './assets/edition_drop_step1.png'
3+
import editionDropStep2 from './assets/edition_drop_step2.png'
4+
import editionDropStep3 from './assets/edition_drop_step3.png'
5+
import editionDropStep4 from './assets/edition_drop_step4.png'
6+
7+
# Deploy a modular Edition Drop contract
8+
9+
The Edition Drop contract also known as “semi-fungible” or “multi” tokens create multiple NFTs from the same asset based on the [ERC-1155 standard](https://eips.ethereum.org/EIPS/eip-1155).
10+
11+
Edition Drop includes settings called claim conditions which allow deployers to set a prices for tokens per claim phase and limits on how many tokens to be released.
12+
13+
### Edition Drop vs Edition
14+
15+
The Edition Drop contract allows users to claim tokens based on specific settings set using Claim Conditions. If you do not need to set limits or special settings on how to claim, refer to the Edition contract.
16+
17+
### Use Cases & Examples
18+
19+
- Create NFT Memberships such as Early Access Cards for users to claim
20+
- Release a limited in-game item
21+
- Create badges, certificates, or passes for real world assets and events
22+
23+
### Default Installed Modules
24+
25+
- Claimable
26+
- BatchMetadata
27+
- Royalty
28+
- SequentialTokenId
29+
30+
### Deploy modular Edition Drop contract
31+
32+
Learn how to deploy a modular Edition Drop contract through the dashboard.
33+
34+
<Steps>
35+
36+
<Step title="Locate Contract">
37+
38+
Navigate to Explore, locate the [Modular Edition Drop contract](https://thirdweb.com/thirdweb.eth/ERC1155CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6Ik1pbnRhYmxlRVJDMTE1NSJ9&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkMxMTU1In0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlRyYW5zZmVyYWJsZUVSQzExNTUifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlNlcXVlbnRpYWxUb2tlbklkRVJDMTE1NSJ9&displayName=Modular+Edition), and select the Deploy Now button.
39+
40+
<DocImage src={editionDropStep1} alt="Screenshot Edition Drop contract" />
41+
42+
</Step>
43+
44+
<Step title="Configure Contract Metadata">
45+
Fill in the Contract Metadata including Name, Symbol, Description, and Image.
46+
47+
Contract Metadata serves as your unique identifier.
48+
49+
<DocImage src={editionDropStep2} alt="Screenshot of Edition Drop configure metadata" />
50+
51+
</Step>
52+
53+
54+
<Step title="Configure Sequential Token Id">
55+
Input a number you want your tokens to start at for the sequential token id. If you don’t have a preference to change it, you may input 0.
56+
57+
<DocImage src={editionDropStep3} alt="Screenshot of Edition Drop configure sequential token id" />
58+
59+
</Step>
60+
61+
<Step title="Select Chain">
62+
Select the preferred chain you want to deploy on and select Deploy Now.
63+
64+
<DocImage src={editionDropStep4} alt="Screenshot of Edition Drop select chain" />
65+
66+
<Callout variant="info" title="Any EVM Compatible">
67+
The Edition Drop contract is deployable on any EVM compatible network. [View all available networks.](https://thirdweb.com/chainlist)
68+
</Callout>
69+
If you are signed in with an EOA wallet, you will be prompted to sign the transaction. After that your contract is deployed and you can begin configuring the modules.
70+
</Step>
71+
72+
</Steps>
73+
74+
### Modular Contract
75+
76+
This contract is created using the modular contract framework. Modules on this contract are upgradeable. [Learn more about Modular Contracts.](https://portal.thirdweb.com/contracts/modular-contracts/overview)
77+
78+
### Configure Modules
79+
80+
To configure the modules, navigate to the Modules view:
81+
82+
(Coming soon)
83+
84+
<Callout variant='info' title="Install Modules">
85+
To install additional modules on this contract, navigate to the Modules view after deploying your contract.
86+
</Callout>
Loading
Loading
Loading
Loading
Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
import { createMetadata, DocImage, Steps, Step, Callout, ContractDeployCard } from "@doc";
2+
import editionStep1 from './assets/edition_step1.png'
3+
import editionStep2 from './assets/edition_step2.png'
4+
import editionStep3 from './assets/edition_step3.png'
5+
import editionStep4 from './assets/edition_step4.png'
6+
7+
8+
# Deploy a modular Edition Drop
9+
10+
The Edition contract also known as “semi-fungible” or “multi” tokens create multiple NFTs from the same asset based on the [ERC-1155 standard](https://eips.ethereum.org/EIPS/eip-1155). NFTs are minted to the creator’s wallet as they are added to the collection. NFTs are still transferable, able to be sold on a marketplace, and perform any other actions as defined by ERC-1155.
11+
12+
For advanced use cases, Edition enables signature-minting capabilities.
13+
14+
### Edition vs Edition Drop
15+
16+
Edition does not have lazy minting capabilities or claim conditions. If you’d prefer to define specific settings such as claim limits, start and end times to claim, and more, please refer to the [Edition Drop contract](https://thirdweb.com/thirdweb.eth/ERC1155CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkNsYWltYWJsZUVSQzExNTUifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkMxMTU1In0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlJveWFsdHlFUkMxMTU1In0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlNlcXVlbnRpYWxUb2tlbklkRVJDMTE1NSJ9&displayName=Modular+Edition+Drop).
17+
18+
### Use Cases & Examples
19+
20+
- Create an NFT Collection with multiple copies of each NFT
21+
- Airdrop an NFT to an allowlist of addresses using the same assets and metadata
22+
- Create copies of artwork to be sold on a marketplace
23+
24+
### Default Installed Modules
25+
26+
- Mintable
27+
- BatchMetadata
28+
- Transferable
29+
- SequentialTokenId
30+
31+
### Deploy modular Edition contract
32+
33+
Learn how to deploy a modular Edition contract through the dashboard.
34+
35+
<Steps>
36+
37+
38+
<Step title="Locate Contract">
39+
40+
Navigate to Explore, locate the [Modular Edition contract](https://thirdweb.com/thirdweb.eth/ERC721CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6Ik1pbnRhYmxlRVJDNzIxIn0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkM3MjEifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlRyYW5zZmVyYWJsZUVSQzcyMSJ9&displayName=Modular+NFT+Collection), and select the Deploy Now button.
41+
42+
<DocImage src={editionStep1} alt="Screenshot Edition contract" />
43+
44+
</Step>
45+
46+
<Step title="Configure Contract Metadata">
47+
Fill in the Contract Metadata including Name, Symbol, Description, and Image.
48+
49+
Contract Metadata serves as your unique identifier.
50+
51+
<DocImage src={editionStep2} alt="Screenshot of Edition configure metadata" />
52+
53+
</Step>
54+
55+
56+
<Step title="Configure Sequential Token Id">
57+
Input a number you want your tokens to start at for the sequential token id. If you don’t have a preference to change it, you may input 0.
58+
59+
<DocImage src={editionStep3} alt="Screenshot of Edition configure sequential token id" />
60+
61+
</Step>
62+
63+
<Step title="Select Chain">
64+
Select the preferred chain you want to deploy on and select Deploy Now.
65+
66+
<DocImage src={editionStep4} alt="Screenshot of Edition select chain" />
67+
68+
<Callout variant="info" title="Any EVM Compatible">
69+
The Edition contract is deployable on any EVM compatible network. [View all available networks.](https://thirdweb.com/chainlist)
70+
</Callout>
71+
If you are signed in with an EOA wallet, you will be prompted to sign the transaction. After that your contract is deployed and you can begin configuring the modules.
72+
</Step>
73+
74+
</Steps>
75+
76+
### Modular Contract
77+
78+
This contract is created using the modular contract framework. Modules on this contract are upgradeable. [Learn more about Modular Contracts.](https://portal.thirdweb.com/contracts/modular-contracts/overview)
79+
80+
### Configure Modules
81+
82+
To configure the modules, navigate to the Modules view:
83+
84+
(Coming soon)
85+
86+
<Callout variant='info' title="Install Modules">
87+
To install additional modules on this contract, navigate to the Modules view after deploying your contract.
88+
</Callout>
Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
import { createMetadata, DocImage, Steps, Step, Callout, ContractDeployCard } from "@doc";
2+
import collectionStep1 from './assets/nft_collection_step1.png'
3+
import collectionStep2 from './assets/nft_collection_step2.png'
4+
import collectionStep3 from './assets/nft_collection_step3.png'
5+
import collectionTransferable from '../assets/erc721_transferable.png'
6+
import collectionBatchMetadata from '../assets/erc721_batchmetadata.png'
7+
import collectionMintable from '../assets/erc721_mintable.png'
8+
9+
# Deploy a modular NFT Collection contract
10+
11+
The NFT Collection contract creates a unique collection of NFTs based on the ERC-721A standard. NFTs are minted to the creator’s wallet as they are added to the collection. NFTs are still transferable, able to be sold on a marketplace, and perform any other actions as defined by ERC-721A.
12+
13+
For advanced use-cases requiring , NFT Collection includes signature-based minting capabilities.
14+
15+
### NFT Collection vs NFT Drop
16+
17+
NFT Collection contract does not have lazy minting capabilities or claim conditions. If you’d prefer to define specific settings such as claim limits, start and end times to claim, and more, please refer to the [NFT Drop contract](https://thirdweb.com/thirdweb.eth/ERC721CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkNsYWltYWJsZUVSQzcyMSJ9&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkM3MjEifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlJveWFsdHlFUkM3MjEifQ%3D%3D&displayName=Modular+NFT+Drop).
18+
19+
### Use Cases & Examples
20+
21+
- Create a 1-of-many collection of photography, artwork, or other media to be collected or sold on a marketplace
22+
- Create a 1-of-1 NFT which provide special utility or can be used to gate access to an application
23+
- Create a community-made collection of NFTs using signature-minting
24+
25+
### Default Installed Modules
26+
27+
- Mintable
28+
- BatchMetadata
29+
- Transferable
30+
31+
<Steps>
32+
33+
34+
<Step title="Locate Contract">
35+
36+
Navigate to Explore, locate the [Modular NFT Collection contract](https://thirdweb.com/thirdweb.eth/ERC721CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6Ik1pbnRhYmxlRVJDNzIxIn0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkM3MjEifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlRyYW5zZmVyYWJsZUVSQzcyMSJ9&displayName=Modular+NFT+Collection), and select the Deploy Now button.
37+
38+
<DocImage src={collectionStep1} alt="Screenshot NFT Collection contract" />
39+
40+
</Step>
41+
42+
<Step title="Configure Contract Metadata">
43+
Fill in the Contract Metadata including Name, Symbol, Description, and Image.
44+
45+
Contract Metadata serves as your unique identifier.
46+
47+
<DocImage src={collectionStep2} alt="Screenshot of NFT Collectionconfigure metadata" />
48+
49+
50+
</Step>
51+
52+
<Step title="Select Chain">
53+
Select the preferred chain you want to deploy on and select Deploy Now.
54+
55+
<DocImage src={collectionStep3} alt="Screenshot of Token select chain screen" />
56+
57+
<Callout variant="info" title="Any EVM Compatible">
58+
The NFT Collection contract is deployable on any EVM compatible network. [View all available networks.](https://thirdweb.com/chainlist)
59+
</Callout>
60+
If you are signed in with an EOA wallet, you will be prompted to sign the transaction. After that your contract is deployed and you can begin configuring the modules.
61+
</Step>
62+
63+
</Steps>
64+
65+
### Modular Contract
66+
67+
This contract is created using the modular contract framework. Modules on this contract are upgradeable. [Learn more about Modular Contracts.](https://portal.thirdweb.com/contracts/modular-contracts/overview)
68+
69+
### Configure Modules
70+
71+
To configure the modules, navigate to the Modules view:
72+
73+
- Configure the MintableERC721 module to facilitate minting of ERC721 tokens with sales settings
74+
75+
<DocImage src={collectionMintable} alt="Screenshot of ERC721 Mintable module"/>
76+
77+
- Configure BatchMetadataERC721 to upload the NFT metadata
78+
79+
<DocImage src={collectionBatchMetadata} alt="Screenshot of ERC721 BatchMetadata module"/>
80+
81+
- Configure the Transferable721 Module to restrict transfers, if desired.
82+
83+
<DocImage src={collectionTransferable} alt="Screenshot of ERC721 Transferable module"/>
84+
85+
<Callout variant='info' title="Install Modules">
86+
To install additional modules on this contract, navigate to the Modules view after deploying your contract.
87+
</Callout>
88+
Loading
Loading
Loading
Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
import { createMetadata, DocImage, Steps, Step, Callout, ContractDeployCard } from "@doc";
2+
import nftDropStep1 from './assets/nft_drop_step1.png'
3+
import nftDropStep2 from './assets/nft_drop_step2.png'
4+
import nftDropStep3 from './assets/nft_drop_step3.png'
5+
6+
# Deploy a modular NFT Drop contract
7+
8+
The NFT Drop contract creates a unique collection of NFTs based on the [ERC-721A](https://www.erc721a.org/) standard. NFT Drop allows you to define claim conditions or settings which define how a user can claim an NFT.
9+
10+
### NFT Drop vs NFT Collection
11+
12+
NFT Drop has the Claimable module enabling claim conditions. If you’d prefer to not define specific settings such as claim limits, start and end times to claim, and more, please refer to the [NFT Collection contract](https://thirdweb.com/thirdweb.eth/ERC721CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6Ik1pbnRhYmxlRVJDNzIxIn0%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkM3MjEifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlRyYW5zZmVyYWJsZUVSQzcyMSJ9&displayName=Modular+NFT+Collection).
13+
14+
### Use Cases & Examples
15+
16+
- Create an NFT profile pic collection with each NFT having a different combination of traits
17+
- Release NFTs in phases with exclusivity, discounted, or public phases
18+
- Create restricted-access NFT Drops for allowlisted wallets to claim
19+
20+
### Default Installed Modules
21+
22+
- Claimable
23+
- BatchMetadata
24+
- Royalty
25+
26+
### Deploy a modular NFT Drop contract
27+
28+
Learn how to deploy a modular NFT Drop contract through the dashboard.
29+
30+
<Steps>
31+
32+
33+
<Step title="Locate Contract">
34+
35+
Navigate to Explore, locate the [Modular NFT Drop contract](https://thirdweb.com/thirdweb.eth/ERC721CoreInitializable?module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkNsYWltYWJsZUVSQzcyMSJ9&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IkJhdGNoTWV0YWRhdGFFUkM3MjEifQ%3D%3D&module=eyJwdWJsaXNoZXIiOiJkZXBsb3llci50aGlyZHdlYi5ldGgiLCJtb2R1bGVJZCI6IlJveWFsdHlFUkM3MjEifQ%3D%3D&displayName=Modular+NFT+Drop), and select the Deploy Now button.
36+
37+
<DocImage src={nftDropStep1} alt="Screenshot NFT Drop contract" />
38+
39+
</Step>
40+
41+
<Step title="Configure Contract Metadata">
42+
Fill in the Contract Metadata including Name, Symbol, Description, and Image.
43+
44+
Contract Metadata serves as your unique identifier.
45+
46+
<DocImage src={nftDropStep2} alt="Screenshot of NFT Drop configure metadata" />
47+
48+
49+
</Step>
50+
51+
<Step title="Select Chain">
52+
Select the preferred chain you want to deploy on and select Deploy Now.
53+
54+
<DocImage src={nftDropStep3} alt="Screenshot of NFT Drop select chain screen" />
55+
56+
<Callout variant="info" title="Any EVM Compatible">
57+
The NFT Drop contract is deployable on any EVM compatible network. [View all available networks.](https://thirdweb.com/chainlist)
58+
</Callout>
59+
If you are signed in with an EOA wallet, you will be prompted to sign the transaction. After that your contract is deployed and you can begin configuring the modules.
60+
</Step>
61+
62+
</Steps>
63+
64+
### Modular Contract
65+
66+
This contract is created using the modular contract framework. Modules on this contract are upgradeable. [Learn more about Modular Contracts.](https://portal.thirdweb.com/contracts/modular-contracts/overview)
67+
68+
### Configure Modules
69+
70+
To configure the modules, navigate to the Modules view:
71+
72+
(Coming soon)
73+
74+
<Callout variant='info' title="Install Modules">
75+
To install additional modules on this contract, navigate to the Modules view after deploying your contract.
76+
</Callout>
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)