Start
Plant a coin
Planting a coin on the Plant page, field by field, with the optional first buy, what the wallet approves, each step the screen shows, the planted tree and its share card, what can fail and what it costs.
What planting makes
Planting creates a coin and its tree together. The coin has a supply of 1,000,000,000 with 6 decimals and starts on a Raydium LaunchLab curve. The tree records your wallet as its planter, which earns 0.3% of every trade in the coin from then on.
You need a connected wallet (Connect a wallet), an image, a name and a ticker, and enough SOL for what planting costs.
The form
Open Plant. The form is on the left. On the right a preview shows your coin's tree at Seed with its image, name and ticker as you type, above four figures: "Coins", "Becomes a Tree at", "Your share of every trade" and "Fruit for the kodama who water".
| Field | Type | Rule | The form says |
|---|---|---|---|
Imagerequired | file | PNG, JPG, WebP or GIF, up to 5 MB (5 × 1024 × 1024 bytes). Press Choose image or the circle, or drop a file on the circle. Change image replaces it. | "Choose an image." "Use a PNG, JPG, WebP or GIF." "Keep the image under 5 MB." |
Namerequired | text | 1 to 32 characters. Spaces at either end are dropped. The field stops at 32. | "Give the coin a name." |
Tickerrequired | text | 1 to 10 characters. Typed letters become capitals. The field stops at 10. | "Give the coin a ticker." |
Description | text | Optional. Up to 1,000 characters, with a counter beside the label. | "Keep it to 1,000 characters." |
Website | link | Optional. Starts with https://, up to 200 characters. | "Enter a link that starts with https://" |
X profile | link | Optional. The same rule. | The same. |
Telegram | link | Optional. The same rule. | The same. |
First buy | SOL | Optional. A plain number of SOL, such as 0.5. Empty for none. | "Enter a number." |
A field shows its message once you leave it, and all of them show when you press Plant with something missing. The first field at fault takes the focus.
The name and the ticker are also held to 32 and 10 bytes on chain, so characters outside plain Latin letters and digits take more of the limit than one each. The server reads the image's type from the file's own first bytes, not from its name.
The first buy
The first buy is your own buy of the coin, made as part of the planting, on the same terms as any buy. Type an amount of SOL and the form quotes it against a new curve.
| Under the field | Meaning |
|---|---|
| "Your own buy, made in the same approval as the planting." | The field is empty: no first buy. |
| "You get" | The coins the amount buys. |
| "Fee" | Every fee the buy pays, in SOL. |
| "Spends … SOL, every coin on the curve" | The amount is more than the whole curve takes. The buy spends only the figure shown. |
| "This amount is too small to trade after fees." | Nothing is left to buy with once fees are taken. Raise the amount. |
The planting accepts up to 1% fewer coins than the quote. If the buy would return less than that, the planting fails and nothing is bought.
Plant
Press Plant. Once the name is typed the button reads Plant and the coin's name. The form gives way to a panel headed "Planting" and the name, with its steps.
Uploading the image. The image and the text are stored, and the coin's metadata is made from them.
Building. The planting is built for your wallet: two transactions, the first preparing the tree, the second planting the coin and making the first buy.
Sign in your wallet. The wallet opens once and shows both transactions. Approve them together.
Preparing the tree, then Planting the coin. The first transaction is sent and confirmed, then the second, each as its own step.
Planted. The panel is replaced by the new tree.
The planted tree
The screen shows the coin's tree in its window with its stage, the heading with the coin's name followed by "is planted.", and "Its tree stands in the grove at Seed." A first buy large enough to move the tree on shows the stage it reached instead.
| On the screen | What it is |
|---|---|
| "Your first buy", "Spent", "Fee" | With a first buy: the coins bought, the SOL spent and the fee paid. |
| Open the tree | Goes to the tree's page, /tree/<mint>. |
| Copy link | Copies the tree's address. A toast reads "Link copied." |
| Post on X | Opens a post on X with the text "I planted", the name and ticker, "on Kodama." and the tree's link. |
| The share card | The tree's card, 1200 × 630, as X and other sites show it for the link. It is served at /tree/<mint>/card. |
The new tree is in the grove and under Planted on My trees. The coins of a first buy are in your wallet, not in the tree: move them in to water.
When a step fails
The panel's heading changes to "Not planted yet", the step that failed is marked, and a notice names it with the reason under it. Retry runs the planting again without uploading the same image and text twice. Edit returns to the form with everything you typed.
| The notice says | Reasons it gives | What to do |
|---|---|---|
| "The image and text were not stored." | "Choose a PNG, JPG, GIF, WEBP image." "The file contents do not match its image type." "Choose an image no larger than 5 MB." A message about the storage being unreachable. | For an image message, press Edit and choose another file. Otherwise Retry. |
| "The planting could not be built." | "No launch mint is ready yet. Try again in a moment." "The first buy is too small or above what the curve can fill." "The API could not be reached." | Retry in a moment. For the first buy, press Edit and change the amount. |
| "The wallet did not sign." | "The wallet didn't sign it." with "Nothing was sent. Sign again when you are ready." "The wallet switched accounts after this was built." | Retry and approve. |
| "The signed planting was not sent." | "This launch was held too long before it came back signed. Build it again." | Retry. The server holds a new coin's key for 5 minutes from the build. |
| "The tree was not prepared." | The first transaction failed or expired, with the chain's message. | Retry. |
| "The planting did not confirm." | "The transaction failed." or "The transaction expired.", or the chain's own message, each with what to do next. | Retry. |
| "The coin was not planted." | The tree is prepared and the second transaction did not land. The panel adds "Your tree is prepared. Retry plants the coin into it." | Retry. |
A fault in one field, found by the server, returns you to the form with the message under that field.
If the last step is still open after a while, Check again appears under the steps. It reads the transaction once more and sends nothing.
Resume after the tree was prepared
When the first transaction confirmed and the second did not, the tree is prepared and waits for its coin. Retry on the same screen plants into that tree, and so does Edit followed by Plant, as long as the image and the text are unchanged. You sign again, and the coin gets the same mint.
The SOL of a first buy set aside by the first transaction stays yours. What the planting does not spend returns to your wallet.
What planting costs
| Cost | Paid to | When |
|---|---|---|
| Rent for the tree | The Solana network | The first transaction |
| Rent for the coin on Raydium LaunchLab and, with a first buy, for holding the coin in your wallet | The Solana network | The second transaction |
| The network fee | The Solana network | Each of the two transactions |
| The first buy, if you make one | The coin's curve, for coins sent to your wallet | The second transaction |
| The fee on the first buy | 1.9% to the tree's split, as on every trade, with Raydium's own fee beside it | The second transaction |
Where the 1.9% goes is on Fees and where they go. The form's "Fee" line is the first buy's fee in SOL before you sign.