SoulOGDocumentation
SOULOG / DOCUMENTATION

From your wallet to your first NFT.

A practical guide to SoulOG. Follow the invitation, approval and minting flow, or find the tools for managing your community.

BSC Testnet · Chain ID 97

01 · Quick start

Use a browser wallet that supports BSC Testnet. Open the application, connect your wallet and confirm the switch to BSC Testnet.

  1. Prepare gas: Keep some test BNB (tBNB) in your wallet to pay transaction fees.
  2. Get an invitation: Ask your inviter for an activated invitation address accepted by the current contract.
  3. Check the app: Review registration status, price, remaining quota and mint availability before continuing.
This deployment uses BSC Testnet. Live contract data determines prices, quotas, account roles and whether minting is open.

02 · Registration

Registration establishes a purchasing account and its referral relationship. Select Register on the home page, enter a valid invitation address and confirm the transaction in your wallet. Wait for confirmation on chain.

Activated inviter

Activated by an authorized administrator. activationStatus and purchase registration are separate states.

Registered buyer

Registers through purchaseInvitationCode. The app reads purchaseActivationStatus to determine registration status.

Use a valid invitation address supplied by your inviter. An L2, L3 or L4 administrator role alone does not establish invitation eligibility. Registration on an older contract does not automatically carry over to a new one.

The app refreshes registration status after a successful receipt. If Register still appears, verify the connected address, network and transaction result.

03 · Approve & mint

  1. Register first: Connect your registered wallet and check that minting is open.
  2. Prepare payment tokens: The app reads the token address from the NFT contract’s usdt() getter. Do not identify a token only by its name or mainnet address.
  3. Select quantity: Review price, total cost, balance and remaining mint quota.
  4. Approve: If your allowance is insufficient, confirm a payment-token approval transaction and wait for completion.
  5. Mint: Confirm the mint transaction, wait for its receipt and check My NFT.
Approval and minting are separate transactions. The current app requests the maximum token allowance when you select Approve. Review the spender and allowance in your wallet. Approval alone does not mint an NFT.

04 · Administration

The owner interface is /NFTAdmin. Subordinate administrators use /Admin. Connect the appropriate wallet; visiting an admin page does not grant contract permissions.

Owner tools

Use the available controls for pricing, mint availability, administrators, receivers, ratios and the metadata base URI. Changes require wallet confirmation and contract authorization.

Administrator tools

Manage subordinate accounts and user activation according to your role. The application includes L2, L3 and L4 levels; contract permissions determine which actions are allowed.

  1. Verify the network, connected wallet and NFT contract address.
  2. Read the existing configuration before entering a change.
  3. Review the transaction in your wallet and check the updated values after confirmation.

The current ABI has no payment-token address setter, so the dashboard cannot directly change usdt(). Updating the metadata base URI changes the read path; it does not upload images or JSON files.

05 · Contract & network

Network
BSC Testnet · 97 / 0x61
Gas token
tBNB · 18 decimals
NFT contract
0x9F6794fEF00527c6B55E9D78ff7E7906F9440E8c
Payment token
Read usdt() on the current NFT contract.
RPC
https://data-seed-prebsc-1-s1.bnbchain.org:8545
Metadata
The metadata’s image field points to the NFT image. Its location depends on tokenURI and the configured base URI.

This guide describes the current frontend and ABI. Prices, supply, referral ratios and management relationships can change. Check the app or explorer for live values.

06 · Troubleshooting

Why is my invitation invalid, or my account already activated?

Verify your wallet and the current contract, then check invitation eligibility and whether the buyer is already registered. This message can represent multiple failed contract checks. Administrator status does not itself establish purchase eligibility.

Why is another confirmation needed after approval?

Approve grants a token allowance to the NFT contract. Mint performs the minting operation. Wait for the approval receipt before submitting Mint.

Why does the payment token have no contract code?

Check your wallet network, NFT contract address and the usdt() return value. A token with the same name or address may not be deployed on every network.

Why has the Register button not changed?

Check that the transaction succeeded, rather than merely being submitted. Verify your wallet address, refresh and reconnect. If an RPC read fails, retry later and inspect the chain record.

Why is my NFT image missing?

Confirm the mint succeeded, then check tokenURI, the JSON image field and image URL availability. Deploying the frontend does not ensure an external storage service is available.

Do roles and registrations carry over to a new contract?

The app reads the current contract. Roles, referrals, allowances and NFTs on an older contract do not migrate automatically when the frontend address changes.