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".

FieldTypeRuleThe form says
ImagerequiredfilePNG, 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."
Namerequiredtext1 to 32 characters. Spaces at either end are dropped. The field stops at 32."Give the coin a name."
Tickerrequiredtext1 to 10 characters. Typed letters become capitals. The field stops at 10."Give the coin a ticker."
DescriptiontextOptional. Up to 1,000 characters, with a counter beside the label."Keep it to 1,000 characters."
WebsitelinkOptional. Starts with https://, up to 200 characters."Enter a link that starts with https://"
X profilelinkOptional. The same rule.The same.
TelegramlinkOptional. The same rule.The same.
First buySOLOptional. 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 fieldMeaning
"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

  1. 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.

  2. Uploading the image. The image and the text are stored, and the coin's metadata is made from them.

  3. 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.

  4. Sign in your wallet. The wallet opens once and shows both transactions. Approve them together.

  5. Preparing the tree, then Planting the coin. The first transaction is sent and confirmed, then the second, each as its own step.

  6. 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 screenWhat it is
"Your first buy", "Spent", "Fee"With a first buy: the coins bought, the SOL spent and the fee paid.
Open the treeGoes to the tree's page, /tree/<mint>.
Copy linkCopies the tree's address. A toast reads "Link copied."
Post on XOpens a post on X with the text "I planted", the name and ticker, "on Kodama." and the tree's link.
The share cardThe 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 saysReasons it givesWhat 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

CostPaid toWhen
Rent for the treeThe Solana networkThe first transaction
Rent for the coin on Raydium LaunchLab and, with a first buy, for holding the coin in your walletThe Solana networkThe second transaction
The network feeThe Solana networkEach of the two transactions
The first buy, if you make oneThe coin's curve, for coins sent to your walletThe second transaction
The fee on the first buy1.9% to the tree's split, as on every trade, with Raydium's own fee beside itThe 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.

Next