@oracle-agent/oracle 0.12.0 → 0.13.0

package/artifacts/specialist-packs/oracle-full-crypto.json

@@ -1,295 +0,0 @@
-{
-  "id": "oracle-full-crypto",
-  "name": "Oracle Full Crypto Pack",
-  "version": 4,
-  "audience": "public-users",
-  "description": "Default capability set for public Oracle: trader, builder, analyzer, deterministic /balance aggregation, multichain scanner, meme-token sniping, RFQ routing, tokenized-asset buys, NFT mint gas-war limits, Solana, Bitcoin inscriptions, chain-family token/NFT collections, gacha/DEX launches, and protocol build under bound grants. User signs everything.",
-  "posture": {
-    "default": "DISARMED",
-    "custody": "self-custodial",
-    "signing": "user-wallet-only",
-    "broadcast": "user-or-explicit-grant-only",
-    "never": [
-      "operator-hot-wallet-by-default",
-      "private-executor-custody",
-      "house-custody",
-      "unguarded-broadcast",
-      "uncapped-gas-war-mints"
-    ]
-  },
-  "includes_protocol_build": true,
-  "skill_packs": {
-    "research": [
-      "oracle-token-research",
-      "oracle-contract-research",
-      "oracle-smart-wallet-scanner",
-      "oracle-meme-token-sniper",
-      "oracle-bitcoin",
-      "oracle-solana",
-      "hyperliquid",
-      "polymarket",
-      "oracle-chain-graphs-telegram-cards",
-      "oracle-rfq-tokenized-assets",
-      "oracle-hypercore-staking"
-    ],
-    "execution_prepare": [
-      "self-custodial-onchain-execution",
-      "multichain-exec-desk",
-      "trade-loop-circuit-breaker",
-      "protocol-api-key-integration",
-      "oracle-bitcoin",
-      "oracle-best-execution",
-      "oracle-rfq-tokenized-assets",
-      "oracle-meme-token-sniper",
-      "oracle-nft-mint-gas-war",
-      "oracle-solana-nft",
-      "oracle-hypercore-staking"
-    ],
-    "venues": [
-      "oracle-solana",
-      "oracle-bitcoin",
-      "hyperliquid",
-      "polymarket",
-      "rh-token-research",
-      "rh-token-swap",
-      "rh-token-chart",
-      "oracle-meme-token-sniper",
-      "oracle-rfq-tokenized-assets",
-      "oracle-solana-nft",
-      "oracle-hypercore-staking"
-    ],
-    "protocol_build": [
-      "oracle-protocol-builder",
-      "oracle-contract-research",
-      "oracle-protocol-security",
-      "oracle-multichain-token-launch",
-      "oracle-multichain-nft-launch",
-      "oracle-nft-gacha-launch",
-      "oracle-dex-launch",
-      "protocol-api-key-integration",
-      "oracle-nft-mint-gas-war"
-    ],
-    "product_law": [
-      "oracle-public-product",
-      "oracle-grants",
-      "oracle-receipts",
-      "trade-loop-circuit-breaker",
-      "oracle-chain-graphs-telegram-cards",
-      "oracle-nft-mint-gas-war"
-    ],
-    "launch_build": [
-      "oracle-protocol-builder",
-      "oracle-nft-gacha-launch",
-      "oracle-dex-launch",
-      "oracle-protocol-security",
-      "oracle-multichain-token-launch",
-      "oracle-multichain-nft-launch",
-      "oracle-nft-mint-gas-war"
-    ],
-    "analysis": [
-      "oracle-token-research",
-      "oracle-contract-research",
-      "oracle-smart-wallet-scanner",
-      "oracle-meme-token-sniper",
-      "oracle-best-execution",
-      "balance",
-      "oracle-chain-graphs-telegram-cards",
-      "oracle-rfq-tokenized-assets"
-    ]
-  },
-  "excluded_from_public": [
-    "private deploy ops",
-    "private executor ops",
-    "private chain ops",
-    "operator infrastructure access",
-    "any skill that requires an operator wallet or server root access"
-  ],
-  "protocol_build": {
-    "enabled": true,
-    "modes": [
-      "research-existing-protocol",
-      "scaffold-contracts",
-      "scaffold-nft-or-gacha",
-      "scaffold-dex-or-launchpad",
-      "write-deploy-scripts",
-      "prepare-unsigned-deploy-txs",
-      "security-checklist",
-      "launchpad-public-surface",
-      "multichain-token-launch",
-      "multichain-nft-collection-launch"
-    ],
-    "user_signs": true,
-    "grant_actions_example": [
-      "read:chain",
-      "simulate:tx",
-      "prepare:deploy",
-      "prepare:verify"
-    ],
-    "targets": "user-provided factory/router/implementations only unless added to destination allowlist",
-    "copy": "Oracle can classify and prepare chain-family token, NFT collection, protocol, gacha, and DEX launches. Unsupported adapters fail closed. You still sign every side effect."
-  },
-  "profiles": [
-    {
-      "id": "polymarket-agent",
-      "skills": [
-        "polymarket",
-        "polymarket-trade-journal",
-        "trade-loop-circuit-breaker",
-        "oracle-chain-graphs-telegram-cards"
-      ],
-      "description": "Polymarket prediction markets: public event pricing/cards plus prepared order intents when user CLOB/API keys are configured."
-    },
-    {
-      "id": "hyperliquid-agent",
-      "skills": [
-        "hyperliquid",
-        "hyperliquid-hip4-outcome-markets",
-        "trade-loop-circuit-breaker",
-        "oracle-chain-graphs-telegram-cards",
-        "oracle-rfq-tokenized-assets",
-        "oracle-hypercore-staking"
-      ],
-      "description": "Hyperliquid perps/spot, HyperEVM, HIP-3 builder dexs, HIP-4 outcome markets, and HyperCore HYPE staking/delegation prepares. API-key actions activate only with user-provided keys."
-    },
-    {
-      "id": "robinhood-agent",
-      "skills": [
-        "rh-public-token-research",
-        "rh-token-research",
-        "rh-token-chart",
-        "rh-token-swap",
-        "oracle-meme-token-sniper",
-        "oracle-chain-graphs-telegram-cards",
-        "oracle-rfq-tokenized-assets"
-      ],
-      "description": "Robinhood Chain tokens/NFTs plus tokenized Robinhood-style assets when chain/contract/route is verified."
-    },
-    {
-      "id": "solana-agent",
-      "skills": [
-        "oracle-solana",
-        "oracle-receipts",
-        "oracle-circuit-breaker",
-        "oracle-best-execution",
-        "oracle-meme-token-sniper",
-        "oracle-chain-graphs-telegram-cards",
-        "oracle-rfq-tokenized-assets",
-        "oracle-solana-nft"
-      ],
-      "label": "solana agent",
-      "description": "Solana research, SPL accounts, Jupiter quotes, live simulation, Magic Eden NFT reads plus unsigned buy/list/mint tickets, launch/meme-token scanning, and unsigned swap preparation."
-    },
-    {
-      "id": "bitcoin-agent",
-      "skills": [
-        "oracle-bitcoin",
-        "oracle-receipts",
-        "oracle-circuit-breaker",
-        "oracle-smart-wallet-scanner"
-      ],
-      "label": "bitcoin agent",
-      "description": "Bitcoin L1, Ordinals/runes research, Satflow PSBTs, and inscription preparation."
-    },
-    {
-      "id": "stable-agent",
-      "skills": [
-        "evm-contract-research",
-        "self-custodial-onchain-execution",
-        "oracle-meme-token-sniper",
-        "oracle-chain-graphs-telegram-cards",
-        "oracle-rfq-tokenized-assets"
-      ]
-    },
-    {
-      "id": "protocol-builder",
-      "skills": [
-        "oracle-protocol-builder",
-        "oracle-contract-research",
-        "oracle-protocol-security",
-        "oracle-nft-gacha-launch",
-        "oracle-dex-launch",
-        "oracle-receipts",
-        "oracle-multichain-token-launch",
-        "oracle-multichain-nft-launch"
-      ],
-      "label": "protocol builder",
-      "description": "Classify by chain family, then scaffold, review, and prepare unsigned token, NFT collection, gacha, DEX, and protocol launches."
-    }
-  ],
-  "default_tools": {
-    "read": [
-      "mad_data",
-      "web_search",
-      "evm_quote",
-      "evm_simulate",
-      "btc_health",
-      "btc_fees",
-      "btc_inscription_info",
-      "solana_balance",
-      "portfolio_balance",
-      "portfolio_snapshot",
-      "portfolio_history",
-      "portfolio_value_graph",
-      "nft_inventory",
-      "nft_gallery",
-      "nft_pnl"
-    ],
-    "prepare": [
-      "evm_prepare",
-      "evm_protocol_prepare",
-      "evm_protocol_quote",
-      "jupiter_quote",
-      "jupiter_prepare",
-      "bitcoin_inscribe_prepare",
-      "nft_prepare_list"
-    ],
-    "never_public_default": [
-      "evm_sign",
-      "evm_send",
-      "solana_sign",
-      "solana_send",
-      "bitcoin_sign",
-      "bitcoin_send",
-      "bitcoin_inscribe_sign_commit",
-      "bitcoin_inscribe_sign_reveal"
-    ]
-  },
-  "capabilities": [
-    "trader",
-    "builder",
-    "analyzer",
-    "solana-jupiter",
-    "bitcoin-inscriptions",
-    "nft-project-launch",
-    "gacha-launch",
-    "dex-launch",
-    "meme-token-sniping",
-    "onchain-scanner",
-    "smart-wallet-scanner",
-    "best-execution-routing",
-    "bridges",
-    "perps",
-    "vaults",
-    "prediction-markets",
-    "ordinals-runes",
-    "per-chain-graphs",
-    "telegram-cards",
-    "hip-3-builder-dex",
-    "hip-4-outcome-markets",
-    "polymarket-api-key-trading",
-    "cross-chain-rfq",
-    "rfq-best-execution",
-    "tokenized-robinhood-assets",
-    "nft-mint-gas-war-limits",
-    "nft-mint-bot",
-    "solana-nft-marketplace",
-    "solana-nft-mint",
-    "hypercore-hype-staking",
-    "hypercore-validator-delegation",
-    "multichain-token-launch",
-    "multichain-nft-collection-launch",
-    "multichain-balance",
-    "nft-inventory-gallery-pnl",
-    "portfolio-balance-history-graph"
-  ]
-}

package/dist/action-receipts.mjs

@@ -1 +0,0 @@
-import{createHash as m}from"node:crypto";import{wordlists as g}from"ethers";var A=1,E=new Set(["privatekey","privkey","secretkey","seedphrase","seed","mnemonic","passphrase","password","keystore","keymaterial","wif","xprv","xpriv","bearer","authorization","signature","apikey","credential"]),x=[/\b[5KL][1-9A-HJ-NP-Za-km-z]{50,51}\b/,/\bxprv[0-9A-Za-z]{50,}\b/],$=new Set([12,15,18,21,24]);function S(e){let t=String(e).trim().toLowerCase().split(/\s+/).filter(Boolean);return $.has(t.length)&&t.every(r=>g.en.getWordIndex(r)>=0)}var H=/^\s*(?:0x)?[0-9a-fA-F]{64}\s*$/,O=/(hash|digest|root|salt|nonce|proof|commitment|sig|id)(?:e?s)?$/i,j=new Set(["calldata","data","publickey","pubkey","message","payload","input","extradata"]);function T(e){let t=b(e);return j.has(t)||O.test(t)}var f=class extends Error{constructor(t){super(`action receipt refused: secret-bearing field at ${t}`),this.name="ActionReceiptSecretError",this.code="ACTION_RECEIPT_SECRET"}};function b(e){return String(e).replace(/[^a-z0-9]/gi,"").toLowerCase()}function C(e){let t=b(e);return[...E].some(r=>t.includes(r))}function _(e,t,r){if(typeof t=="string"){if(x.some(o=>o.test(t))||S(t))throw new f(r);if(H.test(t)&&!T(e))throw new f(r)}}function a(e,t="$",r=""){if(e==null||typeof e=="boolean")return e;if(typeof e=="string")return _(r,e,t),e;if(typeof e=="number"){if(!Number.isFinite(e))throw new TypeError(`action receipt: non-finite number at ${t}`);return e}if(typeof e=="bigint")return e.toString();if(Array.isArray(e))return e.map((n,i)=>a(n,`${t}[${i}]`,r));if(typeof e!="object"||Object.getPrototypeOf(e)!==Object.prototype)throw new TypeError(`action receipt: JSON-like value required at ${t}`);let o={};for(let n of Object.keys(e).sort()){let i=`${t}.${n}`;if(C(n))throw new f(i);e[n]!==void 0&&(o[n]=a(e[n],i,n))}return o}function L(e){return a(e)}function d(e){return e===null||typeof e!="object"?JSON.stringify(e):Array.isArray(e)?`[${e.map(d).join(",")}]`:`{${Object.keys(e).map(t=>`${JSON.stringify(t)}:${d(e[t])}`).join(",")}}`}function R(e){return d(a(e))}function k(e){if(!e||typeof e!="object"||Array.isArray(e))throw new TypeError("action receipt: object required");let{receiptId:t,summary:r,...o}=e;return m("sha256").update(R(o)).digest("hex")}function c(e,...t){for(let r of t)if(e[r]!==void 0)return e[r]}function s(e,t,r){let o=c(e,...t);if(o==null)throw new TypeError(`action receipt: ${r} required`);return o}function I(e){let t=c(e,"balances","balanceChanges"),r=c(e,"beforeBalances","balancesBefore","before"),o=c(e,"afterBalances","balancesAfter","after");return t!==void 0?{balances:t}:r===void 0&&o===void 0?{}:{balances:{...r===void 0?{}:{before:r},...o===void 0?{}:{after:o}}}}function N(e={}){if(!e||typeof e!="object"||Array.isArray(e))throw new TypeError("action receipt: input object required");a(e);let t=c(e,"txHash","transactionHash"),r=c(e,"phase","stage","resultType")??(t==null?"prepare":"execute");if(r!=="prepare"&&r!=="execute")throw new TypeError('action receipt: phase must be "prepare" or "execute"');let o={receiptVersion:A,phase:r,intent:s(e,["intent"],"intent"),route:s(e,["route"],"route"),decodedAction:s(e,["decodedAction","action"],"decodedAction"),policyChecks:s(e,["policyChecks","checks"],"policyChecks"),allowlistHits:s(e,["allowlistHits","allowlistMatches"],"allowlistHits"),prepareHash:s(e,["prepareHash"],"prepareHash"),...t==null?{}:{txHash:t},...I(e)},n=a(o);return Object.freeze({...n,receiptId:k(n)})}var q=N;function u(e,t=[]){if(typeof e=="string"||typeof e=="number")return String(e);for(let r of t)if(e?.[r]!=null)return String(e[r]);return"recorded"}function y(e){if(typeof e=="boolean")return e;if(e&&typeof e=="object"){if(typeof e.ok=="boolean")return e.ok;if(typeof e.allowed=="boolean")return e.allowed;if(typeof e.passed=="boolean")return e.passed}return null}function z(e){if(!e||typeof e!="object")throw new TypeError("action receipt: object required");let t=u(e.decodedAction,["type","action","method","name"]),r=u(e.route,["name","provider","venue","id"]),o=Array.isArray(e.policyChecks)?e.policyChecks:Object.values(e.policyChecks||{}),n=o.filter(l=>y(l)===!0).length,i=o.filter(l=>y(l)===!1).length,p=Array.isArray(e.allowlistHits)?e.allowlistHits.length:Object.keys(e.allowlistHits||{}).length,h=e.txHash==null?"no transaction hash":`tx ${e.txHash}`,w=e.balances==null?"balances not provided":"before/after balances recorded";return`${e.phase} ${t} via ${r}; policy ${n} passed, ${i} failed; ${p} allowlist hit${p===1?"":"s"}; ${h}; ${w}; receipt ${e.receiptId}`}var F=z;export{A as ACTION_RECEIPT_VERSION,f as ActionReceiptSecretError,L as assertNoReceiptSecrets,R as canonicalReceiptJson,k as computeReceiptId,q as createActionReceipt,F as formatActionReceipt,N as normalizeActionReceipt,z as summarizeActionReceipt};

package/dist/action-semantics.mjs

@@ -1 +0,0 @@
-var o=Object.freeze({ALERT_ONLY:"alert_only",EXECUTE:"execute"}),i=new Set(["watch","watch this","ping","ping me","alert","notify"]),r=new Set(["watching","armed"]);function a(t){if(typeof t!="string"||!t.trim())throw new TypeError("explicit action verb required");let e=t.trim().toLowerCase().replace(/\s+/g," ");if(i.has(e))return o.ALERT_ONLY;if(e==="arm")return o.EXECUTE;throw new TypeError(`unsupported action verb: ${e}`)}function c(t={}){let{verb:e,...n}=t;return{...n,active:!0,actionMode:a(e)}}function u(t){if(!t||typeof t!="object"||typeof t.active!="boolean")throw new TypeError("active must be boolean");if(!Object.values(o).includes(t.actionMode))throw new TypeError("actionMode must be alert_only or execute");return t}function E(t){return t?.active===!0&&t?.actionMode===o.ALERT_ONLY}function s(t){return t?.active===!0&&t?.actionMode===o.EXECUTE}function p(t={}){if(t.actionMode!==void 0&&t.actionMode!==o.ALERT_ONLY)throw new TypeError("non-alert record cannot enter alert-only watch migration");let e=typeof t.active=="boolean"?t.active:r.has(String(t.status||"").toLowerCase());return{...t,active:e,actionMode:o.ALERT_ONLY}}export{o as ACTION_MODES,a as actionModeForVerb,u as assertActionRecord,c as createActionRecord,E as isActiveAlert,s as isActiveExecution,p as migrateLegacyWatchRecord};

package/dist/address-book.mjs

@@ -1,2 +0,0 @@
-import c from"node:fs";import d from"node:path";import{homedir as b}from"node:os";import{join as h}from"node:path";var w=h(b(),".config","oracle"),z=h(b(),".config","mad-desk");function m(e,r,t=""){let o=process.env[e];if(o!=null&&String(o).trim()!=="")return o;let n=r?process.env[r]:void 0;return n!=null&&String(n).trim()!==""?n:t}var g=/^0x[0-9a-fA-F]{40}$/,_=new Set(["privatekey","private_key","secret","seed","mnemonic","passphrase","signature","keystore"]),D=["privatekey","privkey","secretkey","secret","seedphrase","seed","mnemonic","passphrase","password","keystore","keymaterial","signature","wif","xprv","xpriv","apikey","bearer","credential"],O=[/\b[5KL][1-9A-HJ-NP-Za-km-z]{50,51}\b/,/\bxprv[0-9A-Za-z]{50,}\b/,/\b(?:[a-z]{3,8}\s+){11,}[a-z]{3,8}\b/i],y=/^\s*(?:0x)?[0-9a-fA-F]{64}\s*$/;function I(e){return String(e).toLowerCase().replace(/[^a-z0-9]/g,"")}function L(e,r){let t=I(e);if(_.has(String(e).toLowerCase())||D.some(o=>t.includes(o)))throw new Error(`address-book: ${r} is forbidden; the book stores labels, never key material`)}function N(e,r){if(typeof e=="string"&&(O.some(t=>t.test(e))||y.test(e)))throw new Error(`address-book: ${r} looks like key material; the book stores labels, never key material`)}function E(){let e=m("ORACLE_ADDRESS_BOOK","MAD_ADDRESS_BOOK","");if(e)return d.resolve(e);let r=m("ORACLE_CONFIG_DIR","MAD_CONFIG_DIR",w);return d.join(r,"address-book.json")}function p(e,r="field"){if(Array.isArray(e)){e.forEach((t,o)=>p(t,`${r}[${o}]`));return}if(!e||typeof e!="object"){N(e,r);return}for(let[t,o]of Object.entries(e))L(t,t),p(o,t)}function S(e){let r=String(e||"").trim();if(!g.test(r))throw new Error("address-book: address must be 0x + 40 hex characters");return r.toLowerCase()}function a(e,r){return e==null||e===""?null:String(e).slice(0,r)}function k(){return{version:1,updatedAt:null,entries:[]}}function x(e){return{address:String(e.address).toLowerCase(),label:a(e.label,80)||"unknown",who:a(e.who,120),role:a(e.role,40),chainIds:Array.isArray(e.chainIds)?e.chainIds.map(Number).filter(Number.isFinite):[],notes:a(e.notes,500),source:a(e.source,80),firstSeenAt:e.firstSeenAt||null,lastSeenAt:e.lastSeenAt||null}}function l(){try{let e=JSON.parse(c.readFileSync(E(),"utf8"));if(!e||typeof e!="object")return k();let r=Array.isArray(e.entries)?e.entries:[];return{version:1,updatedAt:e.updatedAt||null,entries:r.filter(t=>t&&typeof t=="object"&&g.test(String(t.address||""))).map(x)}}catch{return k()}}function v(e){let r=E();c.mkdirSync(d.dirname(r),{recursive:!0,mode:448});let t={...e,version:1,updatedAt:new Date().toISOString()},o=d.join(d.dirname(r),`.address-book.${process.pid}.tmp`);c.writeFileSync(o,`${JSON.stringify(t,null,2)}
-`,{mode:384}),c.renameSync(o,r);try{c.chmodSync(r,384)}catch{}return t}function G(e={}){let r=l(),t=r.entries;if(e.role&&(t=t.filter(o=>o.role===String(e.role))),e.who){let o=String(e.who).toLowerCase();t=t.filter(n=>(n.who||"").toLowerCase().includes(o)||(n.label||"").toLowerCase().includes(o))}if(e.q){let o=String(e.q).toLowerCase();t=t.filter(n=>n.address.includes(o)||(n.label||"").toLowerCase().includes(o)||(n.who||"").toLowerCase().includes(o)||(n.notes||"").toLowerCase().includes(o))}return{updatedAt:r.updatedAt,count:t.length,entries:t}}function P(e){let r=S(e),t=l().entries.filter(o=>o.address===r);return{address:r,found:t.length>0,entries:t}}function q(e={}){p(e);let r=S(e.address),t=a(e.label??e.role,80)||"wallet",o=new Date().toISOString(),n=l(),i=n.entries.findIndex(s=>s.address===r&&s.label===t),u=x({address:r,label:t,who:e.who,role:e.role,chainIds:e.chainIds,notes:e.notes,source:e.source||"agent",firstSeenAt:i>=0&&n.entries[i].firstSeenAt||o,lastSeenAt:o});i>=0?n.entries[i]=u:n.entries.push(u);let A=s=>s==="agent"?0:s==="owner"?1:2;n.entries.sort((s,f)=>A(s.role)-A(f.role)||s.label.localeCompare(f.label)||s.address.localeCompare(f.address));let C=v(n);return{ok:!0,entry:u,count:C.entries.length}}function Y(e,r=null){let t=S(e),o=l(),n=o.entries.length;return o.entries=o.entries.filter(i=>i.address!==t?!0:r==null?!1:i.label!==String(r)),v(o),{ok:!0,removed:n-o.entries.length,count:o.entries.length}}export{E as addressBookPath,Y as forgetAddress,G as listAddresses,P as lookupAddress,l as readAddressBook,q as rememberAddress};