@agoric/cosmic-proto 0.4.1-orchestration-dev-096c4e8.0 → 0.4.1-other-dev-fbe72e7.0.fbe72e7

package/README.md

@@ -27,21 +27,14 @@ npm install @agoric/cosmic-proto
 ## Usage
 ### RPC Clients
 
-```js
-import { agoric } from '@agoric/cosmic-proto';
-
-const { createRPCQueryClient } = agoric.ClientFactory; 
-const client = await createRPCQueryClient({ rpcEndpoint: RPC_ENDPOINT });
-
-const swingsetParams = await client.agoric.swingset.params()
-```
+TODO #9200
 
 ### Composing Messages
 
-Import the `agoric` object from `@agoric/cosmic-proto`. 
+Import the `agoric` object from the Agoric bundle.
 
 ```js
-import { agoric } from '@agoric/cosmic-proto';
+import { agoric } from '@agoric/cosmic-proto/agoric/bundle.js';
 
 const {
     installBundle,
@@ -54,18 +47,7 @@ const {
 
 Here are the docs on [creating signers](https://github.com/cosmology-tech/cosmos-kit/tree/main/packages/react#signing-clients) in cosmos-kit that can be used with Keplr and other wallets.
 
-### Initializing the Stargate Client
-
-Use `getSigningAgoricClient` to get your `SigningStargateClient`, with the proto/amino messages full-loaded. No need to manually add amino types, just require and initialize the client:
 
-```js
-import { getSigningAgoricClient } from '@agoric/cosmic-proto';
-
-const stargateClient = await getSigningAgoricClient({
-  rpcEndpoint,
-  signer // OfflineSigner
-});
-```
 ### Creating Signers
 
 To broadcast messages, you can create signers with a variety of options:

package/dist/address-hooks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The default maximum number of characters in a bech32-encoded hooked address.
+ */
+export const DEFAULT_HOOKED_ADDRESS_CHAR_LIMIT: 1024;
+/**
+ * @typedef {Record<string, string | (string | null)[] | null>} HookQuery A
+ * record of query keys mapped to query values.  `null` values denote valueless
+ * keys.  Array values denote multiple occurrences of a key:
+ *
+ *      { key: null } // '?key'
+ *      { key: 'value' } // '?key=value'
+ *      { key: ['value1', 'value2', 'value3'] } // '?key=value1&key=value2&key=value3'
+ *      { key: ['value1', null, 'value3'] } // '?key=value1&key&key=value3'
+ */
+/**
+ * How many bytes are used to store the length of the base address.
+ */
+export const BASE_ADDRESS_LENGTH_BYTES: 2;
+export function decodeBech32(specimen: string, charLimit?: number): {
+    prefix: string;
+    bytes: Uint8Array;
+};
+export function encodeBech32(humanReadablePart: string, bytes: ArrayLike<number>, charLimit?: number): Bech32Address;
+export function joinHookedAddress(baseAddress: string, hookData: ArrayLike<number>, charLimit?: number): Bech32Address;
+export function encodeAddressHook(baseAddress: string, query: HookQuery, charLimit?: number): Bech32Address;
+export function mustDecodeAddressHook(addressHook: string, charLimit?: number): {
+    baseAddress: string;
+    query: HookQuery;
+};
+export function decodeAddressHook(addressHook: string, charLimit?: number): {
+    baseAddress: string;
+    query: HookQuery;
+};
+export function splitHookedAddress(specimen: string, charLimit?: number): {
+    baseAddress: string;
+    hookData: Uint8Array;
+};
+export type Bech32Address = `${string}1${string}`;
+/**
+ * A
+ * record of query keys mapped to query values.  `null` values denote valueless
+ * keys.  Array values denote multiple occurrences of a key:
+ *
+ *      { key: null } // '?key'
+ *      { key: 'value' } // '?key=value'
+ *      { key: ['value1', 'value2', 'value3'] } // '?key=value1&key=value2&key=value3'
+ *      { key: ['value1', null, 'value3'] } // '?key=value1&key&key=value3'
+ */
+export type HookQuery = Record<string, string | (string | null)[] | null>;
+//# sourceMappingURL=address-hooks.d.ts.map

package/dist/address-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-hooks.d.ts","sourceRoot":"","sources":["../src/address-hooks.js"],"names":[],"mappings":"AA8DA;;GAEG;AACH,gDAAiD,IAAI,CAAC;AAEtD;;;;;;;;;GASG;AAEH;;GAEG;AACH,wCAAyC,CAAC,CAAC;AAOpC,uCAJI,MAAM,cACN,MAAM,GACJ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAWjD;AASM,gDALI,MAAM,SACN,SAAS,CAAC,MAAM,CAAC,cACjB,MAAM,GACJ,aAAa,CAWzB;AAyBM,+CALI,MAAM,YACN,SAAS,CAAC,MAAM,CAAC,cACjB,MAAM,GACJ,aAAa,CA6CzB;AASM,+CALI,MAAM,SACN,SAAS,cACT,MAAM,GACJ,aAAa,CAQzB;AASM,mDALI,MAAM,cACN,MAAM,GACJ;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAmBrD;AAQM,+CAJI,MAAM,cACN,MAAM,GACJ;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAcrD;AAQM,6CAJI,MAAM,cACN,MAAM,GACJ;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,CAmDzD;4BA1QY,GAAG,MAAM,IAAI,MAAM,EAAE;;;;;;;;;;;wBAkCrB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC"}

package/dist/address-hooks.js

@@ -0,0 +1 @@
+import{bech32 as e}from"bech32";import o from"query-string";const r=globalThis.harden||Object.freeze;const t=[120,241,112];r(t);export const DEFAULT_HOOKED_ADDRESS_CHAR_LIMIT=1024;export const BASE_ADDRESS_LENGTH_BYTES=2;export const decodeBech32=(o,t=1024)=>{const{prefix:s,words:d}=e.decode(o,t),n=e.fromWords(d),c=new Uint8Array(n);return r({prefix:s,bytes:c})};r(decodeBech32);export const encodeBech32=(o,r,t=1024)=>{const s=e.toWords(r);return e.encode(o,s,t)};r(encodeBech32);export const joinHookedAddress=(e,o,r=1024)=>{const{prefix:s,bytes:d}=decodeBech32(e,r),n=d.length,c=o.length,a=65536;if(n>=a)throw RangeError(`Base address length 0x${n.toString(16)} exceeds maximum 0x${a.toString(16)}`);if(!Number.isSafeInteger(c)||c<0)throw RangeError(`Hook data length ${c} is not a non-negative integer`);const i=t.length,h=new Uint8Array(i+n+c+2);h.set(t,0),h[i-1]|=0,h.set(d,i),h.set(o,i+n);let g=n;for(let e=0;e<2;e+=1)h[h.length-1-e]=255&g,g>>>=8;return encodeBech32(s,h,r)};r(joinHookedAddress);export const encodeAddressHook=(e,r,t)=>{const s=o.stringify(r),d=(new TextEncoder).encode(`?${s}`);return joinHookedAddress(e,d,t)};r(encodeAddressHook);export const mustDecodeAddressHook=(e,t)=>{const{baseAddress:s,hookData:d}=splitHookedAddress(e,t),n=(new TextDecoder).decode(d);if(n&&!n.startsWith("?"))throw Error(`Hook data for ${e} does not start with '?': ${s}${n}`);const c=o.parse(n),a=r({...c});return r({baseAddress:s,query:a})};r(mustDecodeAddressHook);export const decodeAddressHook=(e,o)=>{try{const t=mustDecodeAddressHook(e,o);return r(t)}catch(o){return r({baseAddress:e,query:{}})}};r(decodeAddressHook);export const splitHookedAddress=(e,o=1024)=>{const{prefix:s,bytes:d}=decodeBech32(e,o),n=t.length;let c=255;for(let o=0;o<n;o+=1){let s=d[o];if(o===n-1&&(c=15&s,s&=240),s!==t[o])return r({baseAddress:e,hookData:new Uint8Array})}if(0!==c)throw TypeError(`Unsupported address hook version ${c}`);let a=0;for(let e=1;e>=0;e-=1){const o=d.at(-e-1);if(void 0===o)throw TypeError(`Cannot get base address length from byte ${-e-1} of ${d.length}`);a<<=8,a|=o}const i=a;if(i>d.length-2-n)throw TypeError(`Base address length 0x${i.toString(16)} is longer than specimen length ${d.length-2-n}`);const h=d.subarray(n,n+i),g=encodeBech32(s,h,o),l=d.subarray(n+i,-2);return r({baseAddress:g,hookData:l})};r(splitHookedAddress);

package/dist/address-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-hooks.js","sourceRoot":"","sources":["../src/address-hooks.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC;;;;;;GAMG;AAEH,uBAAuB;AACvB,6BAA6B;AAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;AAElD,8EAA8E;AAC9E,UAAU;AACV,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,KAAK,oBAAoB,EAAE,CAAC;IAC3D,MAAM,KAAK,CAAC,wBAAwB,oBAAoB,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,sEAAsE;AACtE,MAAM,wBAAwB,GAAG;IAC/B,IAAI;IACJ,IAAI;IACJ,IAAI,EAAE,yBAAyB;CAChC,CAAC;AACF,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC;AAEtD;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,QAAQ,EACR,SAAS,GAAG,iCAAiC,EAC7C,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC;AACF,MAAM,CAAC,YAAY,CAAC,CAAC;AAErB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,iBAAiB,EACjB,KAAK,EACL,SAAS,GAAG,iCAAiC,EAC7C,EAAE;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,4BAA4B,CAAC,CAClC,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,SAAS,CAAC,CACnD,CAAC;AACJ,CAAC,CAAC;AACF,MAAM,CAAC,YAAY,CAAC,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,WAAW,EACX,QAAQ,EACR,SAAS,GAAG,iCAAiC,EAC7C,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE/D,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC;IACvC,MAAM,CAAC,GAAG,iBAAiB,CAAC;IAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE3B,MAAM,oBAAoB,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,IAAI,oBAAoB,EAAE,CAAC;QAC9B,MAAM,UAAU,CACd,yBAAyB,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,sBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CACjG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,UAAU,CAAC,oBAAoB,EAAE,gCAAgC,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,UAAU,CAC5B,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,yBAAyB,CAClD,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,oBAAoB,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAExC,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,6EAA6E;IAC7E,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,yBAAyB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;QAC7C,GAAG,MAAM,CAAC,CAAC;IACb,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC3C,OAAO,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE;IAC9D,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,CACT,iBAAiB,WAAW,6BAA6B,WAAW,GAAG,OAAO,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE/C;;OAEG;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AACF,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qEAAqE;QACrE,8BAA8B;QAC9B,OAAO,MAAM,CAAC;YACZ,WAAW,EAAE,WAAW;YACxB,KAAK,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,QAAQ,EACR,SAAS,GAAG,iCAAiC,EAC7C,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC;IACrD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,YAAY,GAAG,CAAC,EAAE,CAAC;YAC3B,+DAA+D;YAC/D,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC;YAChC,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,cAAc,KAAK,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,UAAU,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,oBAAoB,EAAE,CAAC;QACrC,MAAM,SAAS,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,yBAAyB,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,SAAS,CACb,4CAA4C,CAAC,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,EAAE,CACxE,CAAC;QACJ,CAAC;QACD,GAAG,KAAK,CAAC,CAAC;QACV,GAAG,IAAI,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,CAAC;IACd,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,yBAAyB,GAAG,YAAY,EAAE,CAAC;QAChE,MAAM,SAAS,CACb,yBAAyB,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,mCAAmC,KAAK,CAAC,MAAM,GAAG,yBAAyB,GAAG,YAAY,EAAE,CACpI,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC;IAE9E,OAAO,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC;AACF,MAAM,CAAC,kBAAkB,CAAC,CAAC"}