@moonpay/cli 1.51.0 → 1.53.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/{chunk-AOKKDF4V.js → chunk-CMSRMZQS.js} +1 -1
- package/dist/{chunk-GJLMK3FI.js → chunk-LI7T6FYP.js} +2 -2
- package/dist/{chunk-OXRTYCBT.js → chunk-PJQTLUKM.js} +1 -1
- package/dist/{chunk-DMVZB2YH.js → chunk-SBG27RUR.js} +5 -5
- package/dist/{client-EBMO22CL.js → client-E7WGY4SM.js} +1 -1
- package/dist/index.js +2 -2
- package/dist/{ledger-S3A7KL23.js → ledger-3OF4RQCR.js} +2 -2
- package/dist/{mcp-YYGFZ5UU.js → mcp-IQG4LAES.js} +1 -1
- package/dist/{store-C3SIF4VO.js → store-HETMUI6M.js} +1 -1
- package/package.json +1 -1
- package/skills/moonpay-onboarding/SKILL.md +171 -0
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
process.noDeprecation = true; import { createRequire as __createRequire } from "module"; const require = __createRequire(import.meta.url);
|
|
2
|
-
import{b as a,c as b}from"./chunk-
|
|
2
|
+
import{b as a,c as b}from"./chunk-PJQTLUKM.js";import"./chunk-CMSRMZQS.js";import"./chunk-LMDE72OE.js";export{a as moonpay,b as resetClient};
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
process.noDeprecation = true; import { createRequire as __createRequire } from "module"; const require = __createRequire(import.meta.url);
|
|
3
|
-
import{a as J,b as K,c as R,d as C}from"./chunk-
|
|
3
|
+
import{a as J,b as K,c as R,d as C}from"./chunk-SBG27RUR.js";import{b as N}from"./chunk-PJQTLUKM.js";import{m as A}from"./chunk-LI7T6FYP.js";import{e as v,g as H}from"./chunk-CMSRMZQS.js";import"./chunk-LMDE72OE.js";import{Command as se}from"commander";var W=!process.env.NO_COLOR&&process.stdout.isTTY===!0;function _(e){return n=>W?`${e}${n}\x1B[0m`:n}var d={bold:_("\x1B[1m"),dim:_("\x1B[2m"),green:_("\x1B[32m"),yellow:_("\x1B[33m"),cyan:_("\x1B[36m"),red:_("\x1B[31m")};function O(e){if(e==null)return!0;let n=typeof e;return n==="string"||n==="number"||n==="boolean"}function w(e){return e==null?"-":String(e)}function S(e,n=0){let t=" ".repeat(n);return O(e)?`${t}${w(e)}`:Array.isArray(e)?e.length===0?`${t}${d.dim("(empty)")}`:e.every(O)?e.map(s=>`${t}- ${w(s)}`).join(`
|
|
4
4
|
`):e.map(s=>{if(typeof s!="object"||s===null)return`${t}- ${w(s)}`;let r=Object.entries(s),c=[],[l,u]=r[0];O(u)?c.push(`${t}- ${d.bold(l)}: ${w(u)}`):(c.push(`${t}- ${d.bold(l)}:`),c.push(S(u,n+2)));for(let[p,g]of r.slice(1))O(g)?c.push(`${t} ${d.bold(p)}: ${w(g)}`):(c.push(`${t} ${d.bold(p)}:`),c.push(S(g,n+2)));return c.join(`
|
|
5
5
|
`)}).join(`
|
|
6
6
|
|
|
@@ -14,5 +14,5 @@ ${S(c,n+1)}`).join(`
|
|
|
14
14
|
|
|
15
15
|
Run \`mp skill install\` to install AI skills for Claude Code.
|
|
16
16
|
|
|
17
|
-
`+K).version(v).option("--json","Output as JSON instead of YAML");function ae(){return h.opts().json?"json":"yaml"}function U(e){console.log(F(e,ae()))}function M(){let e=ie();e&&process.stderr.write(e)}h.command("mcp").description("Start MCP server over stdio (for Claude Desktop, Claude Code, etc.)").action(async()=>{let{startMcpServer:e}=await import("./mcp-
|
|
17
|
+
`+K).version(v).option("--json","Output as JSON instead of YAML");function ae(){return h.opts().json?"json":"yaml"}function U(e){console.log(F(e,ae()))}function M(){let e=ie();e&&process.stderr.write(e)}h.command("mcp").description("Start MCP server over stdio (for Claude Desktop, Claude Code, etc.)").action(async()=>{let{startMcpServer:e}=await import("./mcp-IQG4LAES.js");await e()});function q(e,n){let t=e;for(let s of n){let r=t.commands.find(c=>c.name()===s);r||(r=t.command(s)),t=r}return t}function z(e,n=""){let t=[];for(let[s,r]of Object.entries(e)){let c=n?`${n}-${s}`:s,l=r;for(;l._def.typeName==="ZodEffects";)l=l._def.schema;let u=l;u._def.typeName==="ZodNullable"&&(u=u._def.innerType),u._def.typeName==="ZodObject"&&u.shape?t.push(...z(u.shape,c)):t.push({flatKey:c,field:r,path:c.split("-")})}return t}function ce(e,n){let t={};for(let{flatKey:s,path:r}of n){let c=s.replace(/-([a-z])/g,(u,p)=>p.toUpperCase()),l=c in e?e[c]:e[s];if(r.length===1)t[r[0]]=l;else{let u=t;for(let p=0;p<r.length-1;p++)(!u[r[p]]||typeof u[r[p]]!="object")&&(u[r[p]]={}),u=u[r[p]];u[r[r.length-1]]=l}}return t}function le(e,n){for(let t of n){let s=t.schema.name.split("_"),r=s.pop(),l=q(e,s).command(r).description(t.schema.description),u=t.schema.input.shape??{},p=z(u),g=[],b=[],k=[],$=[];for(let{flatKey:f,field:i}of p){let o=i.description??f,a=i;for(;a._def.typeName==="ZodEffects";)a=a._def.schema;let y=a._def.typeName,m=a;m._def.typeName==="ZodNullable"&&(m=m._def.innerType),m._def.typeName==="ZodNumber"&&b.push(f),m._def.typeName==="ZodRecord"&&k.push(f),m._def.typeName==="ZodBoolean"&&$.push(f),y==="ZodBoolean"?l.option(`--${f} [${f}]`,o,!1):y==="ZodNullable"?(l.option(`--${f} <${f}>`,o),g.push(f)):l.requiredOption(`--${f} <${f}>`,o)}l.action(async f=>{t.schema.name.startsWith("consent_")||await R.handler({});for(let o of g){let a=o.replace(/-([a-z])/g,(y,m)=>m.toUpperCase());f[a]===void 0&&(f[a]=null)}for(let o of b){let a=o.replace(/-([a-z])/g,(y,m)=>m.toUpperCase());f[a]!=null&&typeof f[a]=="string"&&(f[a]=Number(f[a]))}for(let o of $){let a=o.replace(/-([a-z])/g,(m,j)=>j.toUpperCase()),y=f[a];if(typeof y=="string"){let m=y.toLowerCase();m==="true"||m==="1"?f[a]=!0:(m==="false"||m==="0")&&(f[a]=!1)}}for(let o of k){let a=o.replace(/-([a-z])/g,(y,m)=>m.toUpperCase());if(typeof f[a]=="string")try{f[a]=JSON.parse(f[a])}catch{console.error(`Invalid JSON for --${o}`),process.exit(1)}}let i=ce(f,p);try{let o=await t.handler(i);U(o)}catch(o){console.error(Z(o)),process.exit(1)}})}}function fe(e){if(e.$ref&&e.definitions){let n=e.$ref.replace("#/definitions/","");return e.definitions[n]}return e}function ue(e){return Array.isArray(e.type)?e.type.includes("null"):e.anyOf?e.anyOf.some(n=>n.type==="null"):!1}function me(e){return Array.isArray(e.type)?e.type.includes("object"):e.anyOf?e.anyOf.some(n=>n.type==="object"):e.type==="object"}function pe(e){return Array.isArray(e.type)?e.type.some(n=>n==="number"||n==="integer"):e.anyOf?e.anyOf.some(n=>n.type==="number"||n.type==="integer"):e.type==="number"||e.type==="integer"}function de(e){return Array.isArray(e.type)?e.type.includes("boolean"):e.anyOf?e.anyOf.some(n=>n.type==="boolean"):e.type==="boolean"}var Y=new Set(["swaps_transaction_build","transaction_register","virtual-account_offramp_initiate","prediction-market_position_buy","prediction-market_position_sell","prediction-market_position_redeem","commerce_cart_update","commerce_checkout_start","commerce_checkout_pay","card_delegation_approve_transaction_build","card_delegation_revoke_transaction_build","card_delegation_token_retrieve","card_wallet_link","card_wallet_unlink"]);function ye(e,n){for(let t of n){if(Y.has(t.name))continue;let s=t.name.split("_"),r=s.pop(),c=q(e,s);if(c.commands.find(i=>i.name()===r))continue;let l=c.command(r).description(t.description),u=fe(t.inputSchema),p=u.properties??{},g=new Set(u.required??[]),b=[],k=[],$=[],f=[];for(let[i,o]of Object.entries(p)){let a=o.description??i,y=ue(o),m=me(o),j=pe(o),B=de(o);j&&k.push(i),B&&f.push(i),m?($.push(i),g.has(i)&&!y?l.requiredOption(`--${i} <json>`,`${a} (as JSON)`):(l.option(`--${i} <json>`,`${a} (as JSON)`),b.push(i))):y||!g.has(i)?(l.option(`--${i} <${i}>`,a),b.push(i)):l.requiredOption(`--${i} <${i}>`,a)}l.action(async i=>{await R.handler({});for(let o of b)i[o]===void 0&&(i[o]=null);for(let o of k)i[o]!=null&&typeof i[o]=="string"&&(i[o]=Number(i[o]));for(let o of f)if(typeof i[o]=="string"){let a=i[o].toLowerCase();a==="true"||a==="1"?i[o]=!0:(a==="false"||a==="0")&&(i[o]=!1)}for(let o of $)if(typeof i[o]=="string")try{i[o]=JSON.parse(i[o])}catch{console.error(`Invalid JSON for --${o}`),process.exit(1)}try{await I(i);let o=await N._call(t.name,i);U(o),M()}catch(o){console.error(Z(o)),process.exit(1)}})}}le(h,C);ye(h,J);h.command("tools").description("List available tools").action(()=>{let e=[...C.map(t=>({name:t.schema.name,description:t.schema.description})),...J.filter(t=>!C.some(s=>s.schema.name===t.name)&&!Y.has(t.name)).map(t=>({name:t.name,description:t.description}))].sort((t,s)=>t.name.localeCompare(s.name)),n=[];for(let t of e){let s=t.name.replace(/_/g," ");n.push(` ${d.green(s.padEnd(28))} ${d.dim(t.description)}`)}n.push(""),n.push(d.dim(`${e.length} tools`)),console.log(n.join(`
|
|
18
18
|
`)),M()});h.parse();
|
|
@@ -7,6 +7,6 @@ Run: npm i -g @moonpay/cli --include=optional`;function y(){try{let e=S("@ledger
|
|
|
7
7
|
`),p}async function U(){if(!p)return null;try{let e=y(),i=f().getDeviceSessionState({sessionId:p}),s=await e.firstValueFrom(i.pipe(e.take(1),e.timeout(3e3)));return s.sessionStateType>=1?s.currentApp?.name??null:null}catch{return null}}var M={evm:"Ethereum",solana:"Solana"};function _(e){let n=String(e);return n.includes("6807")||n.includes("6a15")||n.includes("UnknownDeviceExchangeError")}async function C(e){process.stderr.write(`Installing ${e} app on your Ledger...
|
|
8
8
|
`);let{OpenAppWithDependenciesDeviceAction:n}=y(),i=new n({input:{appName:e}}),t=f().executeDeviceAction({sessionId:E(),deviceAction:i});await m(t,`Install ${e}`,18e4),process.stderr.write(`Installed ${e} app
|
|
9
9
|
`)}async function R(e){let n=M[e];if(!n||await U()===n)return;process.stderr.write(`Opening ${n} app on your Ledger...
|
|
10
|
-
`);let{OpenAppDeviceAction:s}=y(),t=new s({input:{appName:n}}),u=f().executeDeviceAction({sessionId:E(),deviceAction:t});try{await m(u,`Open ${n}`)}catch(c){if(_(c)){await D(),await C(n),await D();return}if(!String(c).includes("isconnect"))throw c}await D()}async function D(){try{await f().disconnect({sessionId:p})}catch{}p=null,await new Promise(e=>setTimeout(e,500)),await P()}function $(e,n=0){switch(e){case"evm":return`44'/60'/${n}'/0/0`;case"solana":return`44'/501'/${n}'/0'`;default:throw new Error(`${e} derivation via Ledger is not supported.`)}}function k(e){return e.startsWith("0x")?e.slice(2):e}function T(e){return e.startsWith("0x")?e:`0x${e}`}async function x(e){let{moonpay:n}=await import("./client-
|
|
10
|
+
`);let{OpenAppDeviceAction:s}=y(),t=new s({input:{appName:n}}),u=f().executeDeviceAction({sessionId:E(),deviceAction:t});try{await m(u,`Open ${n}`)}catch(c){if(_(c)){await D(),await C(n),await D();return}if(!String(c).includes("isconnect"))throw c}await D()}async function D(){try{await f().disconnect({sessionId:p})}catch{}p=null,await new Promise(e=>setTimeout(e,500)),await P()}function $(e,n=0){switch(e){case"evm":return`44'/60'/${n}'/0/0`;case"solana":return`44'/501'/${n}'/0'`;default:throw new Error(`${e} derivation via Ledger is not supported.`)}}function k(e){return e.startsWith("0x")?e.slice(2):e}function T(e){return e.startsWith("0x")?e:`0x${e}`}async function x(e){let{moonpay:n}=await import("./client-E7WGY4SM.js"),s=(await n.chain.retrieve({chain:e})).keyFamily;if(s==="bitcoin")throw new Error("Bitcoin address derivation via Ledger is not yet supported.");if(s==="tron")throw new Error("Tron address derivation via Ledger is not supported. The Ethereum signer cannot interact with the Tron Ledger app.");await R(s);let t=$(s),a=E(),u=f();switch(s){case"evm":{let{SignerEthBuilder:c}=I(),l=new c({dmk:u,sessionId:a}).build().getAddress(t,{skipOpenApp:!1});return(await m(l,"Get Ethereum address")).address}case"solana":{let{SignerSolanaBuilder:c}=L(),l=new c({dmk:u,sessionId:a}).build().getAddress(t,{skipOpenApp:!1});return await m(l,"Get Solana address")}default:throw new Error(`Ledger address derivation not supported for ${s}`)}}async function F(){let e={};try{e.ethereum=await x("ethereum")}catch(n){process.stderr.write(`Failed to get Ethereum address: ${n}
|
|
11
11
|
`)}try{e.solana=await x("solana")}catch(n){process.stderr.write(`Failed to get Solana address: ${n}
|
|
12
|
-
`)}if(!e.ethereum&&!e.solana)throw new Error("Could not derive any addresses from Ledger device");return e}async function H(e,n){let{moonpay:i}=await import("./client-
|
|
12
|
+
`)}if(!e.ethereum&&!e.solana)throw new Error("Could not derive any addresses from Ledger device");return e}async function H(e,n){let{moonpay:i}=await import("./client-E7WGY4SM.js"),t=(await i.chain.retrieve({chain:e})).keyFamily;if(t==="bitcoin")throw new Error("Bitcoin transaction signing via Ledger is not yet supported. Use a software wallet for Bitcoin transactions.");if(t==="tron")throw new Error("Tron transaction signing via Ledger is not supported. Use a software wallet for Tron transactions.");await R(t);let a=$(t),u=E(),c=f();switch(t){case"evm":{let{SignerEthBuilder:d}=I(),l=new d({dmk:c,sessionId:u}).build(),w=T(n.startsWith("0x")?n:Buffer.from(n,"base64").toString("hex")),o=Uint8Array.from(Buffer.from(k(w),"hex")),r=l.signTransaction(a,o,{skipOpenApp:!1}),g=await m(r,"Sign transaction"),{parseTransaction:v,serializeTransaction:A}=await import("viem"),B=v(w);return{transaction:A(B,{r:T(k(g.r)),s:T(k(g.s)),v:BigInt(g.v)})}}case"solana":{let{SignerSolanaBuilder:d}=L(),l=new d({dmk:c,sessionId:u}).build(),{VersionedTransaction:w}=await import("@solana/web3.js"),o=Uint8Array.from(Buffer.from(n,"base64")),r=w.deserialize(o),g=r.message.serialize(),v=l.signTransaction(a,g,{skipOpenApp:!1}),A=await m(v,"Sign Solana transaction");return r.signatures[0]=A,{transaction:Buffer.from(r.serialize()).toString("base64")}}default:throw new Error(`Ledger transaction signing not supported for ${t}`)}}async function V(e,n){let{moonpay:i}=await import("./client-E7WGY4SM.js"),t=(await i.chain.retrieve({chain:e})).keyFamily;if(t==="bitcoin")throw new Error("Bitcoin message signing via Ledger is not yet supported. Use a software wallet for Bitcoin message signing.");if(t==="tron")throw new Error("Tron message signing via Ledger is not supported. Use a software wallet for Tron message signing.");await R(t);let a=$(t),u=E(),c=f();switch(t){case"evm":{let{SignerEthBuilder:d}=I(),w=new d({dmk:c,sessionId:u}).build().signMessage(a,n,{skipOpenApp:!1}),o=await m(w,"Sign message"),r=k(o.r),g=k(o.s),v=o.v.toString(16).padStart(2,"0");return{signature:`0x${r}${g}${v}`}}case"solana":{let{SignerSolanaBuilder:d}=L(),l=new d({dmk:c,sessionId:u}).build(),w=Buffer.from(n,"utf8").toString("hex"),o=l.signMessage(a,w,{skipOpenApp:!1}),r=await m(o,"Sign Solana message");return{signature:(await import("bs58")).default.encode(r)}}default:throw new Error(`Ledger message signing not supported for ${t}`)}}async function q(){if(p){try{await f().disconnect({sessionId:p})}catch{}p=null}if(h){try{h.close()}catch{}h=null}}export{P as connectLedger,q as disconnectLedger,x as ledgerGetAddress,F as ledgerGetAllAddresses,V as ledgerSignMessage,H as ledgerSignTransaction};
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
process.noDeprecation = true; import { createRequire as __createRequire } from "module"; const require = __createRequire(import.meta.url);
|
|
2
|
-
import{a as f,d as u}from"./chunk-
|
|
2
|
+
import{a as f,d as u}from"./chunk-SBG27RUR.js";import{b as d}from"./chunk-PJQTLUKM.js";import"./chunk-LI7T6FYP.js";import{e as l,g as R}from"./chunk-CMSRMZQS.js";import"./chunk-LMDE72OE.js";import{Server as N}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as O}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as T,ListToolsRequestSchema as x}from"@modelcontextprotocol/sdk/types.js";import{zodToJsonSchema as k}from"zod-to-json-schema";R();var y=new Map(u.map(s=>[s.schema.name,s]));function q(s){let n=s.inputSchema;if(n.$ref&&n.definitions){let c=n.$ref.replace("#/definitions/","");return n.definitions[c]??n}return n}async function P(){let s=new N({name:"moonpay",version:l},{capabilities:{tools:{listChanged:!0}}}),n=u.map(e=>({name:e.schema.name,description:e.schema.description,inputSchema:k(e.schema.input)})),c=new Map;for(let e of f){if(y.has(e.name))continue;let t=q(e);c.set(e.name,t.properties??{}),n.push({name:e.name,description:e.description,inputSchema:{type:"object",properties:t.properties??{},...t.required?{required:t.required}:{},...t.additionalProperties!==void 0?{additionalProperties:t.additionalProperties}:{}}})}let h=new Map(n.map(e=>[e.name,e]));s.setRequestHandler(x,async()=>({tools:n.map(e=>({name:e.name,description:e.description,inputSchema:e.inputSchema}))})),s.setRequestHandler(T,async e=>{let{name:t,arguments:o={}}=e.params;if(!h.has(t))return{content:[{type:"text",text:`Unknown tool: ${t}`}],isError:!0};try{let i=y.get(t);if(i){let p=i.schema.input.shape??{};for(let[m,a]of Object.entries(p))o[m]===void 0&&a._def.typeName==="ZodNullable"&&(o[m]=null);let r=await i.handler(o);return{content:[{type:"text",text:JSON.stringify(r,null,2)}]}}let S=c.get(t)??{};for(let[p,r]of Object.entries(S))o[p]===void 0&&(Array.isArray(r.type)?r.type.includes("null"):r.anyOf?.some(w=>w.type==="null"))&&(o[p]=null),(r.type==="number"||r.type==="integer"||Array.isArray(r.type)&&r.type.some(a=>a==="number"||a==="integer")||r.anyOf?.some(a=>a.type==="number"||a.type==="integer"))&&typeof o[p]=="string"&&(o[p]=Number(o[p]));let b=await d._call(t,o);return{content:[{type:"text",text:JSON.stringify(b,null,2)}]}}catch(i){return{content:[{type:"text",text:i instanceof Error?i.message:String(i)}],isError:!0}}});let g=new O;await s.connect(g)}export{P as startMcpServer};
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
process.noDeprecation = true; import { createRequire as __createRequire } from "module"; const require = __createRequire(import.meta.url);
|
|
2
|
-
import{A as v,B as w,f as a,g as b,h as c,i as d,j as e,k as f,l as g,m as h,n as i,o as j,p as k,q as l,r as m,s as n,t as o,u as p,v as q,w as r,x as s,y as t,z as u}from"./chunk-
|
|
2
|
+
import{A as v,B as w,f as a,g as b,h as c,i as d,j as e,k as f,l as g,m as h,n as i,o as j,p as k,q as l,r as m,s as n,t as o,u as p,v as q,w as r,x as s,y as t,z as u}from"./chunk-LI7T6FYP.js";import"./chunk-CMSRMZQS.js";import"./chunk-LMDE72OE.js";export{m as addHardwareWallet,u as addWallet,d as createWallet,j as deleteWallet,l as exportSecret,h as findWallet,i as findWalletOrThrow,a as getVaultPath,e as importMnemonic,f as importPrivateKey,g as listWallets,s as loadWallets,c as migrateWallets,w as mutateWallets,p as owsSignMessage,o as owsSignTransaction,q as owsSignTypedData,n as refreshHardwareAddresses,t as removeWallet,k as renameWallet,b as requireMigrationCheck,r as resolveSigningKey,v as saveWallets};
|
package/package.json
CHANGED
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: moonpay-onboarding
|
|
3
|
+
description: First-run walkthrough for new MoonPay Agents users — sets up a Solana wallet, recommends funding via USDC (fee-free onramp) and SOL (deposit-from-elsewhere), guides the first swap into a tokenized stock (TSLAX, NEURALINK, SPACEX, ANTHRP, OPENAI), then takes them through authoring their first skill, automation, and artifact so they touch every surface of the product in one guided session. Use when the user has just installed the desktop app, says "I just got started", "help me get set up", "what should I do first", or when an empty-state CTA fires this skill.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# MoonPay Agents — Onboarding
|
|
7
|
+
|
|
8
|
+
The user just installed the app and doesn't know what to do first. Walk them through one happy path that touches every surface: wallet → funding → swap → author a skill → schedule an automation → build an artifact. End state: they can describe what each piece does and they have at least one durable thing of their own in each catalog.
|
|
9
|
+
|
|
10
|
+
**Solana only for v1.** Most of the artifact catalog and the xstock catalog live on Solana — focusing keeps the funnel short.
|
|
11
|
+
|
|
12
|
+
**Don't dump all six steps on them up front.** Walk one at a time, check in between, let them skip ahead if they want.
|
|
13
|
+
|
|
14
|
+
## Step 1 — Wallet
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
mp wallet list --json
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
- **At least one wallet has a Solana address** → surface the name + truncated address (`main-sol · 5Cy8…CGCB`). Skip to Step 2.
|
|
21
|
+
- **No wallets** → ask what to name it (default `main`), then:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
mp wallet create --name main
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
The output includes the BIP39 mnemonic. **Surface it once, then tell the user clearly**: write it down or store it in a password manager — anyone with this phrase controls the wallet, MoonPay can't recover it for them.
|
|
28
|
+
|
|
29
|
+
Pause until they confirm they've saved it.
|
|
30
|
+
|
|
31
|
+
## Step 2 — Funding
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
mp token balance list --wallet <name> --chain solana --json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Note the response includes native SOL at the top of `items[]` when present (the address is `So11111111111111111111111111111111111111111`, symbol `SOL`).
|
|
38
|
+
|
|
39
|
+
Branch on what they have:
|
|
40
|
+
|
|
41
|
+
| State | What to say |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Empty wallet | Two paths: **(a)** Onramp USDC via MoonPay buy link — **this is fee-free right now**, so leading with USDC is the cheapest first dollar in. **(b)** SOL is not fee-free to onramp; if you specifically want SOL, deposit it from an existing wallet or exchange via `mp deposit create --chain solana`. SOL is needed for gas on every transaction, so plan to get at least some. |
|
|
44
|
+
| Some USDC, no SOL | They've got the trading capital but no gas. Generate a SOL deposit link with `mp deposit create --chain solana` and explain SOL is needed for every tx. |
|
|
45
|
+
| Some SOL, no USDC | Funded for gas; recommend onramping USDC (fee-free) for swap capital, OR swap a bit of SOL → USDC right now via the `moonpay-swap-tokens` skill. |
|
|
46
|
+
| Both SOL + USDC | Skip to Step 3. |
|
|
47
|
+
|
|
48
|
+
For the fiat onramp, hand off to the `moonpay-buy-crypto` skill — it generates the right MoonPay buy URL and opens it in a browser. **Always mention the USDC fee-free angle** when the user is buying stablecoins.
|
|
49
|
+
|
|
50
|
+
## Step 3 — First position
|
|
51
|
+
|
|
52
|
+
The point here is to show the agent can do interesting trades, not just hold stablecoins. Start small ($10-50) and **give the user a choice** between a single position and a pre-built portfolio. Don't pick for them.
|
|
53
|
+
|
|
54
|
+
### Option A — Single tokenized stock
|
|
55
|
+
|
|
56
|
+
A focused bet on one company. Surface this list and let them pick one:
|
|
57
|
+
|
|
58
|
+
- **TSLAX** — Tesla
|
|
59
|
+
- **NEURALINK** — Neuralink
|
|
60
|
+
- **SPACEX** — SpaceX
|
|
61
|
+
- **ANTHRP** — Anthropic PreStock
|
|
62
|
+
- **OPENAI** — OpenAI PreStock
|
|
63
|
+
|
|
64
|
+
Once they choose:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
mp token search --query <SYMBOL> --chain solana --limit 3 --json
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Pluck the address, then hand off to `moonpay-swap-tokens` skill with `from` = USDC and `to` = their pick.
|
|
71
|
+
|
|
72
|
+
### Option B — Frontier Lab Portfolio
|
|
73
|
+
|
|
74
|
+
A pre-baked 50/50 split between the two leading frontier AI labs:
|
|
75
|
+
- 50% **ANTHRP** (Anthropic PreStock)
|
|
76
|
+
- 50% **OPENAI** (OpenAI PreStock)
|
|
77
|
+
|
|
78
|
+
If the user picks this, halve their chosen USD amount and run two swaps via `moonpay-swap-tokens`:
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# First leg
|
|
82
|
+
mp token swap --wallet <name> --chain solana \
|
|
83
|
+
--from-token <USDC> --from-amount <HALF> \
|
|
84
|
+
--to-token <ANTHRP-mint>
|
|
85
|
+
|
|
86
|
+
# Second leg
|
|
87
|
+
mp token swap --wallet <name> --chain solana \
|
|
88
|
+
--from-token <USDC> --from-amount <HALF> \
|
|
89
|
+
--to-token <OPENAI-mint>
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
After both land, surface the combined position summary: "You now hold $X of ANTHRP and $Y of OPENAI — a Frontier Lab basket on Solana."
|
|
93
|
+
|
|
94
|
+
### Caveats to call out for either path
|
|
95
|
+
|
|
96
|
+
These are SPV-wrapped fractional exposure: owning the token gives you price exposure but not voting rights, dividends, or direct ownership in the underlying company. Settlement and price discovery happen on-chain, on Solana.
|
|
97
|
+
|
|
98
|
+
### After the swap(s) land
|
|
99
|
+
|
|
100
|
+
Point them at the **Token Deep Dive** artifact in the app — they can search for any of the tokens they just bought and see the chart + market data + their position.
|
|
101
|
+
|
|
102
|
+
## Step 4 — Author their first skill
|
|
103
|
+
|
|
104
|
+
Their first user-authored skill. Suggest a portfolio-rebalance skill since it's useful and read-only (no irreversible actions):
|
|
105
|
+
|
|
106
|
+
Invoke `moonpay-skill-builder`. Walk them through naming it (`my-portfolio-rebalance` is fine) and writing the description. The skill body should:
|
|
107
|
+
|
|
108
|
+
- Run `mp portfolio retrieve --json` to get the current allocation.
|
|
109
|
+
- Compare against a target allocation the user defines (e.g. 60% USDC, 20% SOL, 20% xstocks).
|
|
110
|
+
- Surface drift per position: which ones are over target (sell candidates), which are under (buy candidates).
|
|
111
|
+
- **Read-only** — don't actually trade. List recommendations only.
|
|
112
|
+
|
|
113
|
+
After save, the skill lands at `~/.moonpay-agents/.agents/skills/my-portfolio-rebalance/SKILL.md`. Tell the user it'll show up in the **Skills view → Yours** filter on next refresh.
|
|
114
|
+
|
|
115
|
+
## Step 5 — Schedule it as an automation
|
|
116
|
+
|
|
117
|
+
Now they have a useful skill — show them how to make it recurring.
|
|
118
|
+
|
|
119
|
+
Invoke `moonpay-automation-builder`. Recipe:
|
|
120
|
+
|
|
121
|
+
- **Name**: "Weekly portfolio check"
|
|
122
|
+
- **Body**: "Use the my-portfolio-rebalance skill. Run the drift report for my main-sol wallet."
|
|
123
|
+
- **Cron**: `0 9 * * 1` (Monday 9am local)
|
|
124
|
+
- **Backend**: `claude` (default)
|
|
125
|
+
|
|
126
|
+
The builder writes the entry into `~/.moonpay-agents/automations.json`. Tell the user it'll show up in the **Automations view** with an inline Switch they can flip if they want to pause it later.
|
|
127
|
+
|
|
128
|
+
## Step 6 — Build the visualization artifact
|
|
129
|
+
|
|
130
|
+
Last step — show them the artifact runtime by building a portfolio pie chart.
|
|
131
|
+
|
|
132
|
+
Invoke `moonpay-artifact-builder`. Recipe:
|
|
133
|
+
|
|
134
|
+
- **Slug**: `my-portfolio-pie`
|
|
135
|
+
- **Title**: "Portfolio"
|
|
136
|
+
- **What it does**: On load, call `mp portfolio retrieve --json` via `window.mp.run`. Render a Chart.js doughnut chart of holdings by USD value. Use the design-system tokens from the skill (color palette, font-mono for numbers, tabular-nums alignment). Add a refresh button that re-pulls the balances.
|
|
137
|
+
|
|
138
|
+
The artifact-builder skill has all the design system + bridge contract in its body — let it drive the authoring.
|
|
139
|
+
|
|
140
|
+
After save it lands at `~/.moonpay-agents/artifacts/my-portfolio-pie.html`. Tell the user it'll show up in the **Artifacts view → Yours** filter.
|
|
141
|
+
|
|
142
|
+
## Wrap-up recap
|
|
143
|
+
|
|
144
|
+
End the session with a one-shot summary listing exactly what they now have:
|
|
145
|
+
|
|
146
|
+
> You're set. Here's what you've got:
|
|
147
|
+
> - **Wallet**: `<name>` (`<truncated-address>`) — your mnemonic is safely stored
|
|
148
|
+
> - **Funded with**: $X USDC + Y SOL
|
|
149
|
+
> - **Position**: $X of <SYMBOL>
|
|
150
|
+
> - **Skill**: `my-portfolio-rebalance` (Skills view → Yours)
|
|
151
|
+
> - **Automation**: "Weekly portfolio check" runs Mondays at 9am (Automations view)
|
|
152
|
+
> - **Artifact**: `my-portfolio-pie` (Artifacts view → Yours)
|
|
153
|
+
>
|
|
154
|
+
> From here, try the **Token Deep Dive** artifact for any token, or ask me to set up a price alert, a trailing stop, or another recurring task. Run `mp skill list` to see every skill the agent knows.
|
|
155
|
+
|
|
156
|
+
## Important rules
|
|
157
|
+
|
|
158
|
+
- **Never auto-create a wallet without asking** — the mnemonic is a one-time-show secret, the user has to be ready to record it.
|
|
159
|
+
- **USDC fee-free is the only fiat onramp angle worth leading with right now** — don't promise fee-free SOL onramp; it isn't.
|
|
160
|
+
- **Don't skip steps** because you think they're obvious — the whole point is the user touches every surface.
|
|
161
|
+
- **Pause between steps** to let the user ask questions or peel off if they want to dig into one piece.
|
|
162
|
+
- **End with the recap** so the user remembers what they made.
|
|
163
|
+
|
|
164
|
+
## Related
|
|
165
|
+
|
|
166
|
+
- `moonpay-auth` — runs before this if the user isn't signed in yet.
|
|
167
|
+
- `moonpay-buy-crypto` — fiat onramp link generation (use this for the USDC-fee-free path).
|
|
168
|
+
- `moonpay-deposit` — crypto deposit links (use this for SOL from existing wallets).
|
|
169
|
+
- `moonpay-swap-tokens` — the actual swap execution in Step 3.
|
|
170
|
+
- `moonpay-skill-builder`, `moonpay-automation-builder`, `moonpay-artifact-builder` — Steps 4, 5, 6.
|
|
171
|
+
- **Token Deep Dive** artifact (in the desktop app) — recommended post-onboarding for exploring tokens.
|