Uploading a Citizen Through the Contract: Difference between revisions

From Neo Tokyo Citizen Wiki
No edit summary
No edit summary
Line 7: Line 7:
=== Requirements ===
=== Requirements ===
Creating a Citizen requires:
Creating a Citizen requires:
* Enough ETH for multiple, large gas fees (0.2+ to ensure that you can complete the process)
* Enough ETH for multiple transaction fees (0.02+ to ensure that you can complete the process)
* These component NFTs must be in the ethereum wallet you are connecting to Etherscan:
* These component NFTs must be in the ethereum wallet you are connecting to Etherscan:
** An [[Identity]] or a [[Bought Identity]]
** An [[Identity]] or a [[Bought Identity]]
Line 13: Line 13:
** [[Land Deed]] NFT
** [[Land Deed]] NFT
** (Optional) a [[Vault]] can be used to increase the [[$BYTE]] yield of the resulting Citizen.  
** (Optional) a [[Vault]] can be used to increase the [[$BYTE]] yield of the resulting Citizen.  
* The token ID for each component


'''Note:''' You can reduce costs by uploading a Citizen when gas fees are low.
'''Note:''' You can reduce costs by uploading a Citizen when gas fees are low.
Line 35: Line 36:
|}
|}


# Open each contract in a browser tab.
==== Set approval for all of the component contracts ====
 
You’ll need to do this before uploading:
Use function #4. createCitizen.
To approve you need to go into each contract and call "setApprovalForAll".
 
Pass in the citizen contract (0xb668beB1Fa440F6cF2Da0399f8C28caB993Bdd65) as the operator, and 1 for approved
You need to fill in every parameter. So if you don't have a vault, put 0. Put 0 for gender too until females are released. And if you don't want a message put "".


If you're getting an error, make sure you've approved all of the token's contracts. You’ll need to do this before uploading:
==== Upload via the Citizen contract ====
# Open the Citizen contract, click the '''Contract''' tab, and click the '''Write Contract''' tab within that frame.
# Use the '''Connect to Web3''' button to connect your wallet with the required components and ethereum.
# Expand function 4, <code>4.createCitizen.</code> and fill in every parameter with the correct token ID for each of your component NFTs.
## If you don't have a vault, put <code>0</code>.
## Select <code>0</code> for a male Citizen or <code>1</code> for a female Citizen.
## specialMessage is a custom message associated with your Citizen that will appear on exchanges in the description field. If you want to leave that field empty use <code>""</code>.


To approve you need to go into each contract and call "setApprovalForAll".
If you get an error, make sure you set approval for all in the component contracts.
Pass in the citizen contract (0xb668beB1Fa440F6cF2Da0399f8C28caB993Bdd65) as the operator, and 1 for approved

Revision as of 10:30, 21 September 2022

If Web3 functionality of the official website is unreachable or disabled, a Citizen can be created interacting with the Citizen contract and all the component contracts on Etherscan.

Using Etherscan and contracts to upload

This process requires the user to write information to several contracts with ethereum transactions using the wallet containing the correct Neo Tokyo component NFTs.

Requirements

Creating a Citizen requires:

  • Enough ETH for multiple transaction fees (0.02+ to ensure that you can complete the process)
  • These component NFTs must be in the ethereum wallet you are connecting to Etherscan:
  • The token ID for each component

Note: You can reduce costs by uploading a Citizen when gas fees are low.

S1 Info.jpg


Etherscan Instructions

Contract Etherscan URL
Citizen Contract https://etherscan.io/address/0xb668beb1fa440f6cf2da0399f8c28cab993bdd65
ID or Bought ID (you only need one of the Identity contracts, depending on your ID) ID: https://etherscan.io/address/0x86357a19e5537a8fba9a004e555713bc943a66c0#writeContract
--
Bought ID: https://etherscan.io/address/0x835a60cc60b808e47825daa79a9da6c9ff3a892e#writeContract
Items Cache https://etherscan.io/address/0x0938e3f7ac6d7f674fed551c93f363109bda3af9#writeContract
Land Deed https://etherscan.io/address/0x3c54b798b3aad4f6089533af3bdbd6ce233019bb#writeContract
Vault (optional) https://etherscan.io/address/0xab0b0dd7e4eab0f9e31a539074a03f1c1be80879#writeContract

Set approval for all of the component contracts

You’ll need to do this before uploading: To approve you need to go into each contract and call "setApprovalForAll". Pass in the citizen contract (0xb668beB1Fa440F6cF2Da0399f8C28caB993Bdd65) as the operator, and 1 for approved

Upload via the Citizen contract

  1. Open the Citizen contract, click the Contract tab, and click the Write Contract tab within that frame.
  2. Use the Connect to Web3 button to connect your wallet with the required components and ethereum.
  3. Expand function 4, 4.createCitizen. and fill in every parameter with the correct token ID for each of your component NFTs.
    1. If you don't have a vault, put 0.
    2. Select 0 for a male Citizen or 1 for a female Citizen.
    3. specialMessage is a custom message associated with your Citizen that will appear on exchanges in the description field. If you want to leave that field empty use "".

If you get an error, make sure you set approval for all in the component contracts.

Retrieved from "https://neotokyowiki.com/wiki/index.php?title=Uploading_a_Citizen_Through_the_Contract&oldid=4761"