@oracle-agent/oracle 0.28.27 → 0.28.29

package/dist/governance-prepare.mjs

@@ -0,0 +1,2 @@
+import{wordlists as k}from"ethers";var G=new Set(["privatekey","privkey","secretkey","seedphrase","seed","mnemonic","passphrase","password","keystore","keymaterial","wif","xprv","xpriv","bearer","authorization","signature","apikey","credential"]),z=[/\b[5KL][1-9A-HJ-NP-Za-km-z]{50,51}\b/,/\bxprv[0-9A-Za-z]{50,}\b/],L=new Set([12,15,18,21,24]);function B(e){let o=String(e).trim().toLowerCase().split(/\s+/).filter(Boolean);return L.has(o.length)&&o.every(t=>k.en.getWordIndex(t)>=0)}var H=/^\s*(?:0x)?[0-9a-fA-F]{64}\s*$/,D=/(hash|digest|root|salt|nonce|proof|commitment|sig|id)(?:e?s)?$/i,q=new Set(["calldata","data","publickey","pubkey","message","payload","input","extradata"]);function F(e){let o=I(e);return q.has(o)||D.test(o)}var N=class extends Error{constructor(o){super(`action receipt refused: secret-bearing field at ${o}`),this.name="ActionReceiptSecretError",this.code="ACTION_RECEIPT_SECRET"}};function I(e){return String(e).replace(/[^a-z0-9]/gi,"").toLowerCase()}function U(e){let o=I(e);return[...G].some(t=>o.includes(t))}function M(e,o,t){if(typeof o=="string"){if(z.some(r=>r.test(o))||B(o))throw new N(t);if(H.test(o)&&!F(e))throw new N(t)}}function $(e,o="$",t=""){if(e==null||typeof e=="boolean")return e;if(typeof e=="string")return M(t,e,o),e;if(typeof e=="number"){if(!Number.isFinite(e))throw new TypeError(`action receipt: non-finite number at ${o}`);return e}if(typeof e=="bigint")return e.toString();if(Array.isArray(e))return e.map((n,i)=>$(n,`${o}[${i}]`,t));if(typeof e!="object"||Object.getPrototypeOf(e)!==Object.prototype)throw new TypeError(`action receipt: JSON-like value required at ${o}`);let r={};for(let n of Object.keys(e).sort()){let i=`${o}.${n}`;if(U(n))throw new N(i);e[n]!==void 0&&(r[n]=$(e[n],i,n))}return r}function d(e){return $(e)}function _(e){return e===null||typeof e!="object"?JSON.stringify(e):Array.isArray(e)?`[${e.map(_).join(",")}]`:`{${Object.keys(e).map(o=>`${JSON.stringify(o)}:${_(e[o])}`).join(",")}}`}function P(e){return _($(e))}var O=1,y="Unsigned prepare material only; no vote, signature, or broadcast occurred.",J=Object.freeze(["proposal","delegation","vote"]),K=Object.freeze(["pending","active","succeeded","queued","executed","defeated","canceled","expired","unknown"]),X=Object.freeze(["for","against","abstain"]),Y=Object.freeze(["delegate","undelegate"]),W=new Set(J),Z=new Set(K),Q=new Set(X),ee=new Set(Y),te=/[\u0000-\u001f\u007f]/,oe=new Set(["active"]),ne=new Set(["executed","defeated","canceled","expired"]),T=class extends Error{constructor(o,t="GOVERNANCE_PREPARE_INVALID"){super(`governance prepare: ${o}`),this.name="GovernancePrepareError",this.code=t}};function s(e,o){throw new T(e,o)}function b(e){if(e&&typeof e=="object"&&!Object.isFrozen(e)){for(let o of Object.values(e))b(o);Object.freeze(e)}return e}function l(e,o){return(!e||typeof e!="object"||Array.isArray(e)||Object.getPrototypeOf(e)!==Object.prototype)&&s(`${o} must be a plain object`),e}function p(e,o,{optional:t=!1,lower:r=!1}={}){if(e==null&&t)return null;typeof e!="string"&&s(`${o} must be a string`);let n=e.trim();return n||s(`${o} is required`),te.test(n)&&s(`${o} contains control characters`),n.length>2048&&s(`${o} is too long`),r?n.toLowerCase():n}function g(e,o,{optional:t=!1,positive:r=!1}={}){if(e==null&&t)return null;typeof e=="number"&&s(`${o} must be an exact decimal string or BigInt; Number coercion is refused`,"GOVERNANCE_UNSAFE_NUMBER");let n;typeof e=="bigint"?n=e.toString():typeof e=="string"?n=e.trim():s(`${o} must be an exact decimal string or BigInt`),/^\d+$/.test(n)||s(`${o} must be a non-negative base-10 integer string`);let i=BigInt(n);return r&&i===0n&&s(`${o} must be positive`),i.toString()}function m(e,o){return e==null?null:p(e,o)}function h(e,o){for(let t of o)if(e[t]!==void 0)return e[t]}function re(e,o="action"){let t=p(e,o,{lower:!0});return W.has(t)||s(`${o} must be proposal, delegation, or vote`),t}function se(e,o="proposal.state"){e==null&&s(`${o} is required`,"GOVERNANCE_MISSING_PROPOSAL_STATE");let t=p(e,o,{lower:!0});return Z.has(t)||s(`${o} is not a recognized proposal state`),t==="unknown"&&s(`${o} is unknown; voting and execution fail closed`,"GOVERNANCE_UNKNOWN_PROPOSAL_STATE"),t}function ae(e){let o=p(e,"support",{lower:!0});return Q.has(o)||s("support must be for, against, or abstain"),o}function R(e,{accountRequired:o=!0}={}){return b({chain:p(h(e,["chain","chainId","network"]),"chain",{lower:!0}),governor:p(h(e,["governor","governorAddress","governance","contract"]),"governor"),account:p(h(e,["account","address","owner","voter","from","proposer"]),"account",{optional:!o})})}function ie(e,o="adapter"){if(e==null&&s(`${o} is required; unsigned prepare material is never invented`,"GOVERNANCE_MISSING_ADAPTER"),typeof e=="function")return{prepare:e};let t=l(e,o);typeof(t.prepare??t.build??t.preview)!="function"&&s(`${o}.prepare must be a function`);for(let n of["sign","broadcast","execute","send","submit","vote"])typeof t[n]=="function"&&s(`${o} must not expose ${n}; this surface is unsigned prepare only`,"GOVERNANCE_ADAPTER_EXECUTION");return t}function ce(e,o="adapter.prepare"){e==null&&s(`${o} returned nothing`),(typeof e!="object"||Array.isArray(e))&&s(`${o} must return a plain object`);let t=e;for(let r of["signed","signature","txHash","broadcast","executed","voted"])t[r]===!0&&s(`${o} claimed ${r}; votes never occur here`,"GOVERNANCE_CLAIMED_EXECUTION");return t.phase&&t.phase!=="prepare"&&s(`${o}.phase must remain prepare`),(t.executionReady===!0||t.signingReady===!0||t.broadcastReady===!0)&&s(`${o} must not mark execution, signing, or broadcast ready`,"GOVERNANCE_CLAIMED_EXECUTION"),d(t),t}function pe(e){let o=h(e,["unsigned","payload","calldata","transaction","message","typedData"]),t=m(e.kind??e.type??(o==null?"preview":"unsigned"),"adapter.kind"),r=m(e.note??e.summary,"adapter.note"),n={kind:t,unsigned:o??null,digest:m(e.digest??e.hash??e.prepareHash,"adapter.digest")};return r&&(n.note=r),b(n)}function w(e,o){let t=m(o.tenantId??e.tenantId,"tenantId");return t?{tenantId:t}:{}}function S(e,o,t="asOf"){return g(o.asOf??e.asOf,t)}function de(e,o={}){d(e),d(o);let t=l(e,"proposal");l(o,"options");let r=S(t,o),n=R(t,{accountRequired:!1}),i=p(h(t,["proposalId","id"]),"proposalId"),c=se(h(t,["state","status","proposalState"])),a=m(t.title??t.name,"title"),f=m(t.description??t.body??t.summary,"description"),u=m(t.proposer,"proposer"),v=g(t.startBlock??t.start,"startBlock",{optional:!0}),E=g(t.endBlock??t.end,"endBlock",{optional:!0}),A=g(t.forVotes??t.votesFor,"forVotes",{optional:!0}),V=g(t.againstVotes??t.votesAgainst,"againstVotes",{optional:!0}),C=g(t.abstainVotes??t.votesAbstain,"abstainVotes",{optional:!0}),j={recordVersion:O,recordType:"governance-proposal",label:y,asOf:r,chain:n.chain,governor:n.governor,proposalId:i,state:c,votable:oe.has(c),terminal:ne.has(c),title:a,description:f,proposer:u,startBlock:v,endBlock:E,tallies:{forVotes:A,againstVotes:V,abstainVotes:C},occurred:!1,...w(t,o)};return b(j)}function le(e,o={}){d(e),d(o);let t=l(e,"intent");l(o,"options");let r=S(t,o),n=R(t),i=t.mode??(t.action==="undelegate"?"undelegate":"delegate"),c=p(i,"mode",{lower:!0});ee.has(c)||s("mode must be delegate or undelegate");let a=c==="undelegate"?m(t.delegatee??t.to,"delegatee"):p(t.delegatee??t.to,"delegatee"),f=g(h(t,["votingPower","votes","power","balance"]),"votingPower",{positive:!0}),u={recordVersion:O,recordType:"governance-delegation-intent",label:y,action:"delegation",mode:c,asOf:r,chain:n.chain,governor:n.governor,account:n.account,delegatee:c==="undelegate"?a??n.account:a,votingPower:f,occurred:!1,...w(t,o)};return b(u)}function fe(e,o={}){d(e),d(o);let t=l(e,"intent");l(o,"options");let r=S(t,o),n=de(t.proposal??t,o);n.votable||s(`proposal ${n.proposalId} is ${n.state} and is not votable`,"GOVERNANCE_PROPOSAL_NOT_VOTABLE");let i=R({...t,chain:t.chain??n.chain,governor:t.governor??n.governor}),c=ae(t.support??t.choice??t.vote),a=g(h(t,["votingPower","votes","power","weight"]),"votingPower",{positive:!0}),f=m(t.reason??t.comment,"reason"),u={recordVersion:O,recordType:"governance-vote-intent",label:y,action:"vote",asOf:r,chain:i.chain,governor:i.governor,account:i.account,proposalId:n.proposalId,proposalState:n.state,support:c,votingPower:a,reason:f,occurred:!1,voted:!1,signed:!1,broadcast:!1,proposal:n,...w(t,o)};return b(u)}function ue(e,o={}){d(e);let t=l(e,"intent"),r=S(t,o),n=R(t),i=p(t.title??t.name,"title"),c=p(t.description??t.body,"description"),a=t.targets;(!Array.isArray(a)||a.length===0)&&s("targets must be a non-empty array");let f=(t.values??a.map(()=>"0")).map((E,A)=>g(E,`values[${A}]`));f.length!==a.length&&s("values length must match targets");let u=(t.calldatas??t.data??[]).map((E,A)=>p(String(E),`calldatas[${A}]`));u.length!==a.length&&s("calldatas length must match targets");let v=g(h(t,["votingPower","proposalThreshold","threshold"]),"votingPower",{positive:!0});return b({recordVersion:O,recordType:"governance-proposal-intent",label:y,action:"proposal",asOf:r,chain:n.chain,governor:n.governor,account:n.account,title:i,description:c,targets:a.map((E,A)=>p(E,`targets[${A}]`)),values:f,calldatas:u,votingPower:v,occurred:!1,...w(t,o)})}function ge(e,o,t){return e==="vote"?fe(o,t):e==="delegation"?le(o,t):ue(o,t)}function ye(e){return e.action==="vote"?[`Unsigned vote preview for proposal ${e.proposalId} on ${e.governor}.`,`Support: ${e.support}. Voting power: ${e.votingPower} (exact base units).`,`Proposal state is ${e.proposalState}. No ballot is submitted.`,y]:e.action==="delegation"?[`Unsigned ${e.mode} preview on ${e.governor}.`,`Account ${e.account} \u2192 ${e.delegatee}. Voting power: ${e.votingPower}.`,"No delegation transaction is signed or broadcast.",y]:[`Unsigned proposal preview on ${e.governor}: ${e.title}.`,`${e.targets.length} target(s). Voting power: ${e.votingPower}.`,"No proposal is submitted.",y]}function me(e={},o={}){d(e),d(o);let t=l(e,"intent");l(o,"options"),o.asOf==null&&t.asOf==null&&s("explicit asOf required","GOVERNANCE_MISSING_ASOF");let r=re(t.action??t.type??o.action??he(t)),n=ge(r,{...t,action:r},o);return b({recordVersion:O,recordType:"governance-preview",label:y,action:r,asOf:n.asOf,occurred:!1,voted:!1,signed:!1,broadcast:!1,executionReady:!1,signingReady:!1,broadcastReady:!1,lines:ye(n),intent:n,...w(t,o)})}function he(e){if(e.support!=null||e.choice!=null||e.proposalId!=null)return"vote";if(e.delegatee!=null||e.mode==="delegate"||e.mode==="undelegate")return"delegation";if(e.targets!=null||e.title!=null)return"proposal";s("action is required")}function be(e,o,t){let r=e.prepare.length>=2?e.prepare(o,t):e.prepare({intent:o,preview:t,action:o.action});return r&&typeof r.then=="function"&&s("adapter.prepare must be synchronous; this surface is deterministic","GOVERNANCE_ADAPTER_ASYNC"),ce(r)}function Ee(e){l(e,"options");let{adapter:o,...t}=e;return d(t),e}function x(e={},o={}){d(e);let t=Ee(o),r=l(e,"intent");t.asOf==null&&r.asOf==null&&s("explicit asOf required","GOVERNANCE_MISSING_ASOF");let n=ie(t.adapter),{adapter:i,...c}=t,a=me(r,c),f=pe(be(n,a.intent,a)),u={recordVersion:O,recordType:"governance-prepare",label:y,action:a.action,asOf:a.asOf,occurred:!1,voted:!1,signed:!1,broadcast:!1,executionReady:!1,signingReady:!1,broadcastReady:!1,preview:a,intent:a.intent,unsigned:f,...w(r,o)};return b(u)}var Ne=x,$e=(e,o={})=>x({...e,action:"vote"},o),Re=(e,o={})=>x({...e,action:"delegation"},o),Se=(e,o={})=>x({...e,action:"proposal"},o);function xe(e){return`${P(e)}
+`}export{J as GOVERNANCE_ACTIONS,Y as GOVERNANCE_DELEGATION_MODES,y as GOVERNANCE_PREPARE_LABEL,O as GOVERNANCE_PREPARE_VERSION,K as GOVERNANCE_PROPOSAL_STATES,X as GOVERNANCE_VOTE_SUPPORT,T as GovernancePrepareError,xe as canonicalGovernanceJson,Ne as createGovernancePrepare,le as normalizeDelegationIntent,de as normalizeProposalRecord,fe as normalizeVoteIntent,Re as prepareDelegation,x as prepareGovernanceAction,Se as prepareProposal,$e as prepareVote,me as previewGovernanceAction};