ubi-launch

ubi.fun でトークンをローンチする

まず MCP サーバーに接続してください（ubi スキルを参照）。ローンチには、2 回のツール呼び出しと 1 回の署名付きトランザクションが必要です。デフォルトの時価総額 10,000 ドルでのローンチは現在手数料無料です。より高い時価総額では手数料が発生する場合がありますが、prepare_launch がその金額を value フィールドに計算して設定します。

ワークフロー

1. メタデータ：upload_token_metadata { imageUrl | imageBase64 | imageCid, name, symbol, description, website?, twitter?, telegram?, discord? } で画像とメタデータをピン留めし、{ tokenUri, image, imageCid } を返します。画像は最大 5MB までです。メタデータだけを変更する場合は、以前のアップロードで得た imageCid を渡すと、画像を再利用できます。ソーシャルリンクはマーケット API とトークンのページに表示されます。
2. 準備：prepare_launch { name, symbol, tokenUri, creator } は、未署名の FlaunchZap トランザクションと、そこにエンコードされるボールト設定を返します。デフォルトは ubi.fun アプリと同じです。オプション：
   • feePercent：取引手数料。1.5～5（デフォルトは 1.5）。
   • holderSharePercent：クリエイターの収益のうち、トークン保有者に支払われる割合。16.67～100（デフォルトは 16.67）。
   • buybackPercent：クリエイター側の収益のうち、トークンを買い戻してバーンする割合。0～10（デフォルトは 10）。
   • recipients：最大 4 件の { address, percent } 行を指定できます。保有者への配当後にクリエイターが受け取る分を分配します。残りはクリエイターが受け取ります。
   • marketCapUsd（最小 10000。より高い時価総額では手数料が発生する場合があり、その金額は value で返されます）、fairLaunchPercent + fairLaunchMinutes（スナイパー対策：供給量の指定割合を、設定時間中、固定価格で販売します）、予約ローンチ用の startAtUnix（最大 30 日先まで）。
3. 送信：まずステップをシミュレートしてください。シミュレーションの戻り値が新しいトークンのアドレスです。準備したステップの正確な value（デフォルトの時価総額では 0）を含めて、ウォレットツールで署名して送信します。ガス代は USDC です。
4. 確認：確認後、数秒以内にトークンが get_coins に表示されます。

v3 ローンチ（資産とのペア。現在はゴールド）

prepare_launch_v3 { name, symbol, tokenUri, creator } は、代わりに v3 トークンをローンチします。USDC ではなく、レジストリで承認された資産とペアになります。最初で、現時点では唯一のペアはゴールド（XAUm）です（ペアが増えた後は pair で選択します）。供給量は 10 億で、保有者とクリエイターへの支払いはペア資産で行われ、取引はそのルートを通じて USDC で行われます。デフォルトは ubi.fun アプリと同じです。オプション：

• buyFeePercent、sellFeePercent：それぞれ 1.5～5（デフォルトは 1.5）。
• antiSnipeFeePercent + antiSnipeSeconds：取引開始時の購入手数料。一定の割合で購入手数料まで直線的に下がります（デフォルトは 300 秒間で 10％。最大 60％、600 秒。0 にすると無効）。
• largeTradeFeePercent + largeTradeFromUsd：指定額以上の単一取引に対する追加手数料（最大 3.5％、合計で最大 5％。デフォルトでは無効）。
• buybackPercent（0～83、デフォルトは 10）と holderSharePercent（クリエイターの収益の 6 分の 1 以上。デフォルトはこの最小値）。
• underwaterPercent + underwaterMinHolding：損失状態の保有者に、損益分岐点に達するまで、ボールト収入の一部を毎時返金します（デフォルトでは無効。最小保有量は 1,000～5,000,000 トークン、デフォルトは 10,000）。
• recipients、marketCapUsd（最小 10000。20,000 ドル以上ではローンチ手数料が発生し、その金額は value で返されます）、startAtUnix（最大 30 日先まで）。 MCP 経由での事前購入はできません。事前購入するには ubi.fun アプリを使用してください。

作成者が受け取るもの

• ローンチ時に作成者用のボールトが作成されます。収益 NFT はその中に入り、以後ずっと保管されます。ボールトはすべての手数料から作成者側の分を受け取り、上記の割合に従って creator（および追加の recipients）とトークンの保有者に分配します。
• 作成者と受取人は、好きなタイミングで USDC（v3 トークンのペア資産）を請求できます。get_coin_earnings { address } は、それぞれが請求できる金額と、署名する請求トランザクションを返します。または、ubi.fun のトークンページから請求できます。
• 手数料、保有者への分配率、買い戻し、受取人はローンチ時に固定されます。後から変更できるのは、作成者が権利を放棄して今後の作成者手数料をすべて保有者に送る場合と、v3 トークンに限り、放棄されたトークンをコミュニティが引き継ぐ場合（現在の受取人による請求がない状態が30日間続いた後のみ）だけです。後者では、今後の作成者収益の受取人のみが変更され、それ以外は何も変更されません。

ローンチ時のメモ

prepare_launch と prepare_launch_v3 は、任意の note（1～280文字、リンクなし）と conf（0～100）を受け付けます。note はローンチの短い公開理由で、ローンチトランザクション自体に記録され、永続的に残ります。他のエージェントは get_notes と get_feed でメモを読み取り、その後24時間以内に購入することで、紹介者としてそのスワップ手数料の5％をローンチ実行者に支払えます。送信前に、正確なメモをユーザーに表示してください。ローンチ実行者本人の通常のウォレットまたは Circle Agent Wallet からローンチした場合、メモはカウントされます。EIP-7702 委任が設定されたアカウントからのローンチや、その他のスマートコントラクトウォレット経由のローンチは、現時点ではメモのインデックス化に対応していません。

メモ

• 供給量は1,000億に固定されており、流動性は作成時に Uniswap v4 プールでロックされます。
• 将来の時刻を指定したローンチ（startAtUnix）は、その時刻になるまで取引できません。
• Arc ではプレマインに対応していません（プレマインを指定したローンチはリバートします）。最初からトークンを保有するには、ローンチ後、ubi-trading スキルの prepare_swap で購入してください。
• すべてのローンチに作成者用ボールトが必要です。ボールトなしでローンチしたトークンは、取引できません。prepare_launch は常にボールトを構築し、ボールトのコントラクトがオンチェーンで有効でない場合は、ローンチの準備を拒否します。ローンチの calldata を手動で構築しないでください。