Start
Connect a wallet
Which Solana wallets connect to Kodama on desktop, Android and iOS, what connecting shares, what the nav shows once connected, and how to disconnect or switch accounts.
Which wallets connect
There is no fixed list of wallets: every Solana wallet in your browser is offered, when it meets all of these.
| The wallet | Why |
|---|---|
| Works on a Solana chain | Every action is a Solana transaction. |
| Can connect | It shares one account's address with the page. |
| Can sign transactions | Every action is approved in the wallet. |
| Is a software wallet | The list holds software wallets. Wallets named Ledger, Trezor, Keystone, Lattice, NGRAVE or Ellipal are left out of it. |
How the wallet reaches the page depends on the device.
| Device | How it connects |
|---|---|
| Desktop | A wallet extension in the browser announces itself, and its name and icon appear in the list. |
| Android | Kodama registers Mobile Wallet Adapter, which joins the same list. Choosing it hands the approval to the wallet app installed on the phone. |
| iOS | Kodama runs inside the wallet's own browser, where the wallet announces itself as an extension does on desktop. In any other iOS browser the list holds links that open the page you are on inside Phantom, Solflare or Backpack. |
Connect
Press Connect wallet. The button is at the right of the nav on every page. On a narrow screen it reads "Connect". A sheet titled "Connect a wallet" opens. Until the browser has looked for wallets it reads "Looking for wallets…".
Choose your wallet. The sheet lists each wallet found, by icon and name. Press yours.
On iOS outside a wallet, the sheet reads "Open Kodama inside your wallet's browser." above three links: Phantom, Solflare and Backpack. Press one, and the same page opens inside that wallet. Then start again from step 1 there.
Approve in the wallet. The wallet asks whether to share an account with Kodama. While it waits, the button shows a spinner.
See the connected state. The sheet closes. The button now shows a green dot and your address, shortened to its first four and last four characters.
Actions on a page that need a wallet show the same button in their place while none is connected, with a line such as "Connect a wallet to water." Connecting there is the same four steps.
What connecting shares
Connecting shares one thing: the address of the account you approved. With it the site reads what that address holds and has done on Kodama: its coins, its trees, its fruit, its echoes and the trees it planted.
Connecting signs nothing and moves nothing. It gives the site no way to move SOL or coins. Each action (plant, buy, sell, move in, move out, water, pick, claim) builds its own transaction and opens the wallet for you to approve that one transaction.
What the nav shows once connected
| Place | Before | After |
|---|---|---|
| The wallet button | Connect wallet | A green dot and your shortened address |
| The places in the nav | Grove, Plant, How it works, Fruit, Docs | The same, then My trees |
Press the wallet button to open the sheet "Your wallet". It holds your whole address, a button to My trees, and Disconnect.
On a phone the places sit in the menu and in the tray at the bottom of the screen: Grove, Plant and My trees.
The site remembers which wallet you used in this browser. On your next visit it reconnects to that wallet without a prompt, when the wallet allows it.
Disconnect
Press the wallet button. The sheet "Your wallet" opens.
Press Disconnect. The button returns to Connect wallet, My trees leaves the nav, and the site forgets the remembered wallet, so the next visit starts disconnected.
Coins in a tree, fruit and shares stay where they are. They belong to the address, not to the connection, and show again when that address connects.
Switch accounts
Switch the account inside the wallet itself. Kodama follows: the address in the nav changes to the new account, and every page reads that account's trees and fruit from then on. If the wallet stops sharing any account, the site disconnects.
To use another wallet instead, disconnect, press Connect wallet and choose it.
An action in flight belongs to the account it was built for. If the account changes between the build and the signature, the action stops with "The wallet switched accounts after this was built." and "Run it again from the account now connected." Nothing was sent.
What the sheet can say
| The sheet shows | What it means | What to do |
|---|---|---|
| "Looking for wallets…" | The browser has not finished looking. | Wait a moment. |
| "No Solana wallet found in this browser. Install one, then come back and connect." | No wallet announced itself. | Install a Solana wallet extension, or open the site inside your wallet's browser on a phone. |
| "Open Kodama inside your wallet's browser." | iOS, in a browser with no wallet. | Press Phantom, Solflare or Backpack. |
| The wallet's name, then "is not installed in this browser." | The wallet you chose is gone from the list. | Choose another, or install it. |
| The wallet's name, then "shared no account." | The wallet approved and returned no account. | Unlock the wallet, pick an account, connect again. |
| The wallet's name, then "declined to connect.", or the wallet's own message | The request was closed or refused in the wallet. | Press the wallet again and approve. |