@wormhole-foundation/sdk-cosmwasm 0.5.0-alpha.0

package/README.md

@@ -0,0 +1,31 @@
+Cosmwasm
+--------
+
+
+Stuff that idk what to do about yet
+
+
+# RPC
+
+Right now, getRpc on the `Platform` type is sync,  but the cosmjs client `connect` method is async. what do?
+
+
+# Addresses
+
+Contract addresses are 32 bytes
+
+"Regular" addresses are 20 bytes
+
+Each chain has its own special prefix
+
+
+# Transfers into cosmos 
+
+Some knowledge of cosmos payload format is required to format the message correctly. This is somewhat similar to the need to understand Solana ATAs for transferring to Solana.
+
+# Transfers between cosmos chains
+
+No attestation will be created since no VAA is created so `fetchAttestation` is a noop?
+
+
+

package/dist/cjs/address.d.ts

@@ -0,0 +1,29 @@
+import { Address, UniversalAddress } from "@wormhole-foundation/sdk-connect";
+import { AnyCosmwasmAddress } from "./types";
+export declare class CosmwasmAddress implements Address {
+    static readonly contractAddressByteSize = 32;
+    static readonly accountAddressByteSize = 20;
+    readonly platform: "Cosmwasm";
+    readonly address: Uint8Array;
+    readonly domain?: string;
+    readonly denom?: string;
+    readonly denomType?: string;
+    constructor(address: AnyCosmwasmAddress);
+    unwrap(): string;
+    toString(): string;
+    toNative(): this;
+    toUint8Array(): Uint8Array;
+    toUniversalAddress(): UniversalAddress;
+    static isValidAddress(address: string): boolean;
+    private static validAddressLength;
+    static instanceof(address: any): address is CosmwasmAddress;
+    equals(other: CosmwasmAddress | UniversalAddress): boolean;
+}
+declare module "@wormhole-foundation/sdk-connect" {
+    namespace WormholeRegistry {
+        interface PlatformToNativeAddressMapping {
+            Cosmwasm: CosmwasmAddress;
+        }
+    }
+}
+//# sourceMappingURL=address.d.ts.map

package/dist/cjs/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/address.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,gBAAgB,EAGjB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAa,MAAM,SAAS,CAAC;AAqFxD,qBAAa,eAAgB,YAAW,OAAO;IAC7C,MAAM,CAAC,QAAQ,CAAC,uBAAuB,MAAM;IAC7C,MAAM,CAAC,QAAQ,CAAC,sBAAsB,MAAM;IAC5C,SAAgB,QAAQ,aAA8B;IAGtD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAG7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,kBAAkB;IAwDvC,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;IAoBlB,QAAQ;IAIR,YAAY;IAIZ,kBAAkB;IAMlB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ/C,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAajC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,eAAe;IAI3D,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,OAAO;CAO3D;AAED,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAiB,gBAAgB,CAAC;QAChC,UAAU,8BAA8B;YACtC,QAAQ,EAAE,eAAe,CAAC;SAC3B;KACF;CACF"}

package/dist/cjs/address.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CosmwasmAddress = void 0;
+const encoding_1 = require("@cosmjs/encoding");
+const sdk_connect_1 = require("@wormhole-foundation/sdk-connect");
+const platform_1 = require("./platform");
+const types_1 = require("./types");
+/*
+Categories:
+
+Bank Tokens
+
+uatom,ibc/...,factory/...
+
+Contract Tokens
+
+*/
+/*
+Cosmos Addresses
+-----
+
+There are at least 5 types of addresses in Cosmos:
+
+
+  Native Denom
+    ex: "uatom"
+
+    address = [] // 0 bytes
+    domain = undefined
+    denom = "uatom"
+    denomType = "native"
+
+  Contract Address
+    ex: "wormhole1ctnjk7an90lz5wjfvr3cf6x984a8cjnv8dpmztmlpcq4xteaa2xs9pwmzk"
+
+    address = [0x...] // 32 bytes
+    domain = "wormhole"
+    denom = undefined
+    denomType = undefined
+
+  Account Address
+    ex: "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02"
+
+    address = [0x...] // 20 bytes
+    domain = "cosmos"
+    denom = undefined
+    denomType = undefined
+
+  IBC Denom
+    ex: IBC/BAEAC83736444C09656FBE666FB625974FCCDEE566EB700EBFD2642C5F6CF13A
+
+    address = [0x...] // 32 bytes
+    domain = undefined
+    denom = undefined
+    denomType = "IBC"
+
+  Factory Address
+    ex: "factory/inj17vytdwqczqz72j65saukplrktd4gyfme5agf6c/avax"
+
+    address = [0x...] 20 bytes
+    domain = "inj"
+    denom =  "avax"
+    denomType = "factory"
+
+  Transfer Denom
+    ex: transfer/channel-486/factory/wormhole1ctnjk7an90lz5wjfvr3cf6x984a8cjnv8dpmztmlpcq4xteaa2xs9pwmzk/6vxRV62YN1CTZeQM5ZfvCZDCVA4nLhtZcLxziYa7xYqb
+
+    address = [0x...] 32 bytes
+    domain = "wormhole"
+    denom = "6vxRV62YN1CTZeQM5ZfvCZDCVA4nLhtZcLxziYa7xYqb"
+    denomType = "transfer/channel-486/factory"
+*/
+// Factory type addresses may have hex or b64 or bech32 encoded addresses
+function tryDecode(data) {
+    try {
+        return { ...(0, encoding_1.fromBech32)(data) };
+    }
+    catch { }
+    try {
+        return { data: (0, encoding_1.fromHex)(data) };
+    }
+    catch { }
+    try {
+        return { data: (0, encoding_1.fromBase64)(data) };
+    }
+    catch { }
+    throw new Error(`Cannot decode: ${data}`);
+}
+class CosmwasmAddress {
+    static contractAddressByteSize = 32;
+    static accountAddressByteSize = 20;
+    platform = platform_1.CosmwasmPlatform._platform;
+    // the actual bytes of the address
+    address;
+    // The domain is the prefix for the address, like "cosmos" or "ibc"
+    domain;
+    // The denom is the token name, like "uatom" or "usdc"
+    denom;
+    // The denomType is "native", "ibc", or "factory"
+    denomType;
+    constructor(address) {
+        if (CosmwasmAddress.instanceof(address)) {
+            const a = address;
+            this.address = a.address;
+            this.domain = a.domain;
+            this.denom = a.denom;
+            this.denomType = a.denomType;
+            return;
+        }
+        if (typeof address === "string") {
+            // A native denom like "uatom"
+            if (address.length <= 8) {
+                this.address = new Uint8Array(0);
+                this.denom = address;
+                this.denomType = "native";
+                return;
+            }
+            if (address.indexOf("/") !== -1) {
+                // A denom address like "ibc/..." or "factory/..." or "transfer/channel-${id}/factory/..."
+                const chunks = address.split("/");
+                // It's a `transfer/...` denom
+                if (chunks.length >= 3) {
+                    // Address will be second from the last
+                    const { data, prefix } = tryDecode(chunks[chunks.length - 2]);
+                    this.address = data;
+                    this.domain = prefix;
+                    this.denom = chunks[chunks.length - 1];
+                    this.denomType = chunks.slice(0, chunks.length - 2).join("/");
+                }
+                else {
+                    const { data } = tryDecode(chunks[1]);
+                    this.address = data;
+                    this.denomType = chunks[0];
+                }
+            }
+            else {
+                // should be a contract or account address by now
+                if (!CosmwasmAddress.isValidAddress(address))
+                    throw new Error(`Invalid Cosmwasm address:  ${address}`);
+                const { data, prefix } = (0, encoding_1.fromBech32)(address);
+                this.address = data;
+                this.domain = prefix;
+            }
+        }
+        else if (address instanceof Uint8Array) {
+            this.address = address;
+        }
+        else if (sdk_connect_1.UniversalAddress.instanceof(address)) {
+            this.address = address.toUint8Array();
+        }
+        else
+            throw new Error(`Invalid Cosmwasm address ${address}`);
+        if (!CosmwasmAddress.validAddressLength(this.address)) {
+            throw new Error("Expected 20 or 32 bytes address");
+        }
+    }
+    unwrap() {
+        return this.toString();
+    }
+    toString() {
+        // Coin address
+        if (this.denomType !== undefined) {
+            // native asset denom
+            if (this.denomType === "native")
+                return this.denom;
+            // ibc/hex
+            if (this.denomType === "ibc") {
+                // NOTE: this is case sensitive, should be `ibc` not `IBC`
+                return `${this.denomType.toLowerCase()}/${sdk_connect_1.encoding.hex.encode(this.address).toUpperCase()}`;
+            }
+            // ?/factory/address/denom
+            return `${this.denomType}/${(0, encoding_1.toBech32)(this.domain, this.address)}/${this.denom}`;
+        }
+        // contract or account address
+        return (0, encoding_1.toBech32)(this.domain, this.address);
+    }
+    toNative() {
+        return this;
+    }
+    toUint8Array() {
+        return this.address;
+    }
+    toUniversalAddress() {
+        const buff = new Uint8Array(sdk_connect_1.UniversalAddress.byteSize);
+        buff.set(this.address, sdk_connect_1.UniversalAddress.byteSize - this.address.length);
+        return new sdk_connect_1.UniversalAddress(buff);
+    }
+    static isValidAddress(address) {
+        try {
+            const maybe = (0, encoding_1.fromBech32)(address);
+            return CosmwasmAddress.validAddressLength(maybe.data);
+        }
+        catch { }
+        return false;
+    }
+    static validAddressLength(address) {
+        if (address.length !== CosmwasmAddress.contractAddressByteSize &&
+            address.length !== CosmwasmAddress.accountAddressByteSize)
+            throw new Error(`Invalid Cosmwasm address, expected ${CosmwasmAddress.contractAddressByteSize} ` +
+                `or ${CosmwasmAddress.accountAddressByteSize} bytes but got ${address.length}`);
+        return true;
+    }
+    static instanceof(address) {
+        return address.platform === platform_1.CosmwasmPlatform._platform;
+    }
+    equals(other) {
+        if (CosmwasmAddress.instanceof(other)) {
+            return this.toString() === other.toString();
+        }
+        else {
+            return other.equals(this.toUniversalAddress());
+        }
+    }
+}
+exports.CosmwasmAddress = CosmwasmAddress;
+(0, sdk_connect_1.registerNative)(types_1._platform, CosmwasmAddress);
+//# sourceMappingURL=address.js.map

package/dist/cjs/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/address.ts"],"names":[],"mappings":"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"}

package/dist/cjs/chain.d.ts

@@ -0,0 +1,5 @@
+import { Chain, ChainContext, Network } from "@wormhole-foundation/sdk-connect";
+import { CosmwasmChains } from "./types";
+export declare class CosmwasmChain<N extends Network = Network, C extends Chain = CosmwasmChains> extends ChainContext<N, C> {
+}
+//# sourceMappingURL=chain.d.ts.map

package/dist/cjs/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,aAAa,CACxB,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,SAAS,KAAK,GAAG,cAAc,CAChC,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAAG"}

package/dist/cjs/chain.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CosmwasmChain = void 0;
+const sdk_connect_1 = require("@wormhole-foundation/sdk-connect");
+class CosmwasmChain extends sdk_connect_1.ChainContext {
+}
+exports.CosmwasmChain = CosmwasmChain;
+//# sourceMappingURL=chain.js.map

package/dist/cjs/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/chain.ts"],"names":[],"mappings":";;;AAAA,kEAAgF;AAGhF,MAAa,aAGX,SAAQ,0BAAkB;CAAG;AAH/B,sCAG+B"}