@bitgo-beta/sdk-core 8.2.1-beta.201 → 8.2.1-beta.2011

package/dist/src/bitgo/safe/derivableEd25519Pub.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * @prettier
+ *
+ * @experimental Encode/decode helpers for the *derivable* form of a safe slot-④
+ * (`ed25519Multisig`) root public key.
+ *
+ * Wallet Safes v1 soft-derives the backup and BitGo co-signer keys of every minted wallet from the
+ * safe's root public keys, and soft derivation needs a chain code. The secp256k1 slot gets one for
+ * free (a BIP32 xpub is `point || chaincode`); a bare Stellar StrKey `G…` has nowhere to put one.
+ * Per TDD Part II-3 §1.3 we therefore concatenate the chain code onto `pub` rather than introduce a
+ * new field — the same shape BitGo already uses for the MPC slots, whose `commonKeychain` is
+ * `pub || chaincode`.
+ *
+ *   pub = <StrKey ed25519 public key> || <chainCode, 64 lowercase hex>
+ *          exactly 56 chars, 'G…'         exactly 64 chars
+ *   total length exactly 120
+ *
+ * StrKey ed25519 public keys are always exactly 56 characters, so the split is a fixed offset. That
+ * offset is a CROSS-REPO contract shared with wallet-platform, `modules/key-card` and WRW; four
+ * independent implementations drifting produces unrecoverable wallets. Every call site — here and in
+ * the other repos — MUST go through these helpers rather than slicing inline.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DERIVABLE_ED25519_PUB_LENGTH = exports.DERIVABLE_ED25519_CHAIN_CODE_LENGTH = exports.DERIVABLE_ED25519_PUB_SPLIT_OFFSET = void 0;
+exports.isValidEd25519StrKeyPublicKey = isValidEd25519StrKeyPublicKey;
+exports.isValidEd25519ChainCode = isValidEd25519ChainCode;
+exports.encodeDerivableEd25519Pub = encodeDerivableEd25519Pub;
+exports.decodeDerivableEd25519Pub = decodeDerivableEd25519Pub;
+exports.isDerivableEd25519Pub = isDerivableEd25519Pub;
+/**
+ * The fixed character offset at which a composite slot-④ pub splits into (StrKey pub, chain code).
+ * Stellar StrKey ed25519 public keys are a fixed 56 characters, so no length prefix or separator is
+ * needed.
+ *
+ * MUST stay identical to the corresponding constant in wallet-platform, `modules/key-card` and WRW:
+ * a divergent offset splits the pub in the wrong place and derives co-signer keys nobody else can
+ * reproduce, permanently bricking the wallets minted with it.
+ */
+exports.DERIVABLE_ED25519_PUB_SPLIT_OFFSET = 56;
+/** Length of the hex-encoded chain code half (32 bytes). */
+exports.DERIVABLE_ED25519_CHAIN_CODE_LENGTH = 64;
+/** Total length of a well-formed composite pub. */
+exports.DERIVABLE_ED25519_PUB_LENGTH = exports.DERIVABLE_ED25519_PUB_SPLIT_OFFSET + exports.DERIVABLE_ED25519_CHAIN_CODE_LENGTH;
+/**
+ * Chain codes are serialized as LOWERCASE hex only. Uppercase and mixed-case are rejected rather
+ * than normalized: accepting both casings would make the composite pub non-canonical, so the same
+ * key could be stored under two distinct strings and equality against a previously-persisted pub
+ * would spuriously fail.
+ */
+const CHAIN_CODE_REGEX = /^[0-9a-f]{64}$/;
+/** StrKey version byte for an ed25519 public key (`G…`). */
+const STRKEY_VERSION_BYTE_ED25519_PUBLIC_KEY = 6 << 3;
+/** Decoded StrKey payload: 1 version byte + 32-byte key + 2-byte checksum. */
+const STRKEY_DECODED_LENGTH = 35;
+const BASE32_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+const STRKEY_ED25519_PUBLIC_KEY_REGEX = /^G[A-Z2-7]{55}$/;
+/**
+ * Decode an unpadded RFC 4648 base32 string. The caller guarantees the input matched
+ * {@link STRKEY_ED25519_PUBLIC_KEY_REGEX}, so 56 chars × 5 bits = 280 bits = exactly 35 bytes with
+ * no leftover bits — the encoding is unambiguously canonical.
+ */
+function base32Decode(input) {
+    const out = Buffer.alloc((input.length * 5) / 8);
+    let bits = 0;
+    let value = 0;
+    let index = 0;
+    for (const char of input) {
+        value = (value << 5) | BASE32_ALPHABET.indexOf(char);
+        bits += 5;
+        if (bits >= 8) {
+            bits -= 8;
+            out[index++] = (value >>> bits) & 0xff;
+        }
+    }
+    return out;
+}
+/** CRC16-XModem, the checksum Stellar StrKey appends (little-endian) to the versioned payload. */
+function crc16Xmodem(data) {
+    let crc = 0x0000;
+    for (const byte of data) {
+        let code = (crc >>> 8) & 0xff;
+        code ^= byte;
+        code ^= code >>> 4;
+        crc = ((crc << 8) & 0xffff) ^ ((code << 12) & 0xffff) ^ ((code << 5) & 0xffff) ^ code;
+    }
+    return crc & 0xffff;
+}
+/**
+ * Returns true iff `pub` is a valid Stellar StrKey ed25519 public key.
+ *
+ * Implemented here rather than pulled from `stellar-sdk` because `sdk-core` must not depend on a
+ * coin module. The pub half is validated by CHECKSUM, not merely by length and alphabet — a
+ * 56-character `G…` string with a corrupted body is rejected.
+ */
+function isValidEd25519StrKeyPublicKey(pub) {
+    if (!STRKEY_ED25519_PUBLIC_KEY_REGEX.test(pub)) {
+        return false;
+    }
+    const decoded = base32Decode(pub);
+    if (decoded.length !== STRKEY_DECODED_LENGTH || decoded[0] !== STRKEY_VERSION_BYTE_ED25519_PUBLIC_KEY) {
+        return false;
+    }
+    return (crc16Xmodem(decoded.subarray(0, STRKEY_DECODED_LENGTH - 2)) === decoded.readUInt16LE(STRKEY_DECODED_LENGTH - 2));
+}
+/** Returns true iff `chainCode` is exactly 64 lowercase hex characters. */
+function isValidEd25519ChainCode(chainCode) {
+    return CHAIN_CODE_REGEX.test(chainCode);
+}
+/**
+ * Compose a derivable slot-④ root pub from its two halves.
+ *
+ * Throws when either half is malformed: silently emitting a composite whose halves do not round-trip
+ * would persist a root pub from which no correct co-signer key can ever be derived.
+ */
+function encodeDerivableEd25519Pub(pub, chainCode) {
+    if (!isValidEd25519StrKeyPublicKey(pub)) {
+        throw new Error('Invalid derivable ed25519 pub: pub half is not a valid ed25519 public key');
+    }
+    if (!isValidEd25519ChainCode(chainCode)) {
+        throw new Error('Invalid derivable ed25519 pub: chainCode must be 64 lowercase hex characters');
+    }
+    return `${pub}${chainCode}`;
+}
+/**
+ * Split a composite slot-④ root pub back into its two halves.
+ *
+ * Throws unless the input is EXACTLY the composite form. A lenient decode that accepted a bare
+ * 56-character pub would hand callers an empty chain code and derive every co-signer from the same
+ * (zero-length) entropy.
+ */
+function decodeDerivableEd25519Pub(composite) {
+    if (composite.length !== exports.DERIVABLE_ED25519_PUB_LENGTH) {
+        throw new Error(`Invalid derivable ed25519 pub: expected ${exports.DERIVABLE_ED25519_PUB_LENGTH} characters, got ${composite.length}`);
+    }
+    const pub = composite.slice(0, exports.DERIVABLE_ED25519_PUB_SPLIT_OFFSET);
+    const chainCode = composite.slice(exports.DERIVABLE_ED25519_PUB_SPLIT_OFFSET);
+    if (!isValidEd25519StrKeyPublicKey(pub)) {
+        throw new Error('Invalid derivable ed25519 pub: pub half is not a valid ed25519 public key');
+    }
+    if (!isValidEd25519ChainCode(chainCode)) {
+        throw new Error('Invalid derivable ed25519 pub: chainCode must be 64 lowercase hex characters');
+    }
+    return { pub, chainCode };
+}
+/** Returns true iff `composite` is a well-formed derivable slot-④ root pub. */
+function isDerivableEd25519Pub(composite) {
+    try {
+        decodeDerivableEd25519Pub(composite);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVyaXZhYmxlRWQyNTUxOVB1Yi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9iaXRnby9zYWZlL2Rlcml2YWJsZUVkMjU1MTlQdWIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FxQkc7OztBQTRFSCxzRUFXQztBQUdELDBEQUVDO0FBUUQsOERBUUM7QUFTRCw4REFlQztBQUdELHNEQU9DO0FBNUlEOzs7Ozs7OztHQVFHO0FBQ1UsUUFBQSxrQ0FBa0MsR0FBRyxFQUFFLENBQUM7QUFFckQsNERBQTREO0FBQy9DLFFBQUEsbUNBQW1DLEdBQUcsRUFBRSxDQUFDO0FBRXRELG1EQUFtRDtBQUN0QyxRQUFBLDRCQUE0QixHQUFHLDBDQUFrQyxHQUFHLDJDQUFtQyxDQUFDO0FBRXJIOzs7OztHQUtHO0FBQ0gsTUFBTSxnQkFBZ0IsR0FBRyxnQkFBZ0IsQ0FBQztBQUUxQyw0REFBNEQ7QUFDNUQsTUFBTSxzQ0FBc0MsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO0FBRXRELDhFQUE4RTtBQUM5RSxNQUFNLHFCQUFxQixHQUFHLEVBQUUsQ0FBQztBQUVqQyxNQUFNLGVBQWUsR0FBRyxrQ0FBa0MsQ0FBQztBQUMzRCxNQUFNLCtCQUErQixHQUFHLGlCQUFpQixDQUFDO0FBRTFEOzs7O0dBSUc7QUFDSCxTQUFTLFlBQVksQ0FBQyxLQUFhO0lBQ2pDLE1BQU0sR0FBRyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxLQUFLLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO0lBQ2pELElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQztJQUNiLElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUNkLElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUNkLEtBQUssTUFBTSxJQUFJLElBQUksS0FBSyxFQUFFLENBQUM7UUFDekIsS0FBSyxHQUFHLENBQUMs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QUMsQ0FBQyxFQUFFLDBDQUFrQyxDQUFDLENBQUM7SUFDbkUsTUFBTSxTQUFTLEdBQUcsU0FBUyxDQUFDLEtBQUssQ0FBQywwQ0FBa0MsQ0FBQyxDQUFDO0lBQ3RFLElBQUksQ0FBQyw2QkFBNkIsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3hDLE1BQU0sSUFBSSxLQUFLLENBQUMsMkVBQTJFLENBQUMsQ0FBQztJQUMvRixDQUFDO0lBQ0QsSUFBSSxDQUFDLHVCQUF1QixDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUM7UUFDeEMsTUFBTSxJQUFJLEtBQUssQ0FBQyw4RUFBOEUsQ0FBQyxDQUFDO0lBQ2xHLENBQUM7SUFDRCxPQUFPLEVBQUUsR0FBRyxFQUFFLFNBQVMsRUFBRSxDQUFDO0FBQzVCLENBQUM7QUFFRCwrRUFBK0U7QUFDL0UsU0FBZ0IscUJBQXFCLENBQUMsU0FBaUI7SUFDckQsSUFBSSxDQUFDO1FBQ0gseUJBQXlCLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDckMsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0FBQ0gsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQHByZXR0aWVyXG4gKlxuICogQGV4cGVyaW1lbnRhbCBFbmNvZGUvZGVjb2RlIGhlbHBlcnMgZm9yIHRoZSAqZGVyaXZhYmxlKiBmb3JtIG9mIGEgc2FmZSBzbG90LeKRo1xuICogKGBlZDI1NTE5TXVsdGlzaWdgKSByb290IHB1YmxpYyBrZXkuXG4gKlxuICogV2FsbGV0IFNhZmVzIHYxIHNvZnQtZGVyaXZlcyB0aGUgYmFja3VwIGFuZCBCaXRHbyBjby1zaWduZXIga2V5cyBvZiBldmVyeSBtaW50ZWQgd2FsbGV0IGZyb20gdGhlXG4gKiBzYWZlJ3Mgcm9vdCBwdWJsaWMga2V5cywgYW5kIHNvZnQgZGVyaXZhdGlvbiBuZWVkcyBhIGNoYWluIGNvZGUuIFRoZSBzZWNwMjU2azEgc2xvdCBnZXRzIG9uZSBmb3JcbiAqIGZyZWUgKGEgQklQMzIgeHB1YiBpcyBgcG9pbnQgfHwgY2hhaW5jb2RlYCk7IGEgYmFyZSBTdGVsbGFyIFN0cktleSBgR+KApmAgaGFzIG5vd2hlcmUgdG8gcHV0IG9uZS5cbiAqIFBlciBUREQgUGFydCBJSS0zIMKnMS4zIHdlIHRoZXJlZm9yZSBjb25jYXRlbmF0ZSB0aGUgY2hhaW4gY29kZSBvbnRvIGBwdWJgIHJhdGhlciB0aGFuIGludHJvZHVjZSBhXG4gKiBuZXcgZmllbGQg4oCUIHRoZSBzYW1lIHNoYXBlIEJpdEdvIGFscmVhZHkgdXNlcyBmb3IgdGhlIE1QQyBzbG90cywgd2hvc2UgYGNvbW1vbktleWNoYWluYCBpc1xuICogYHB1YiB8fCBjaGFpbmNvZGVgLlxuICpcbiAqICAgcHViID0gPFN0cktleSBlZDI1NTE5IHB1YmxpYyBrZXk+IHx8IDxjaGFpbkNvZGUsIDY0IGxvd2VyY2FzZSBoZXg+XG4gKiAgICAgICAgICBleGFjdGx5IDU2IGNoYXJzLCAnR+KApicgICAgICAgICBleGFjdGx5IDY0IGNoYXJzXG4gKiAgIHRvdGFsIGxlbmd0aCBleGFjdGx5IDEyMFxuICpcbiAqIFN0cktleSBlZDI1NTE5IHB1YmxpYyBrZXlzIGFyZSBhbHdheXMgZXhhY3RseSA1NiBjaGFyYWN0ZXJzLCBzbyB0aGUgc3BsaXQgaXMgYSBmaXhlZCBvZmZzZXQuIFRoYXRcbiAqIG9mZnNldCBpcyBhIENST1NTLVJFUE8gY29udHJhY3Qgc2hhcmVkIHdpdGggd2FsbGV0LXBsYXRmb3JtLCBgbW9kdWxlcy9rZXktY2FyZGAgYW5kIFdSVzsgZm91clxuICogaW5kZXBlbmRlbnQgaW1wbGVtZW50YXRpb25zIGRyaWZ0aW5nIHByb2R1Y2VzIHVucmVjb3ZlcmFibGUgd2FsbGV0cy4gRXZlcnkgY2FsbCBzaXRlIOKAlCBoZXJlIGFuZCBpblxuICogdGhlIG90aGVyIHJlcG9zIOKAlCBNVVNUIGdvIHRocm91Z2ggdGhlc2UgaGVscGVycyByYXRoZXIgdGhhbiBzbGljaW5nIGlubGluZS5cbiAqL1xuXG4vKipcbiAqIFRoZSBmaXhlZCBjaGFyYWN0ZXIgb2Zmc2V0IGF0IHdoaWNoIGEgY29tcG9zaXRlIHNsb3Qt4pGjIHB1YiBzcGxpdHMgaW50byAoU3RyS2V5IHB1YiwgY2hhaW4gY29kZSkuXG4gKiBTdGVsbGFyIFN0cktleSBlZDI1NTE5IHB1YmxpYyBrZXlzIGFyZSBhIGZpeGVkIDU2IGNoYXJhY3RlcnMsIHNvIG5vIGxlbmd0aCBwcmVmaXggb3Igc2VwYXJhdG9yIGlzXG4gKiBuZWVkZWQuXG4gKlxuICogTVVTVCBzdGF5IGlkZW50aWNhbCB0byB0aGUgY29ycmVzcG9uZGluZyBjb25zdGFudCBpbiB3YWxsZXQtcGxhdGZvcm0sIGBtb2R1bGVzL2tleS1jYXJkYCBhbmQgV1JXOlxuICogYSBkaXZlcmdlbnQgb2Zmc2V0IHNwbGl0cyB0aGUgcHViIGluIHRoZSB3cm9uZyBwbGFjZSBhbmQgZGVyaXZlcyBjby1zaWduZXIga2V5cyBub2JvZHkgZWxzZSBjYW5cbiAqIHJlcHJvZHVjZSwgcGVybWFuZW50bHkgYnJpY2tpbmcgdGhlIHdhbGxldHMgbWludGVkIHdpdGggaXQuXG4gKi9cbmV4cG9ydCBjb25zdCBERVJJVkFCTEVfRUQyNTUxOV9QVUJfU1BMSVRfT0ZGU0VUID0gNTY7XG5cbi8qKiBMZW5ndGggb2YgdGhlIGhleC1lbmNvZGVkIGNoYWluIGNvZGUgaGFsZiAoMzIgYnl0ZXMpLiAqL1xuZXhwb3J0IGNvbnN0IERFUklWQUJMRV9FRDI1NTE5X0NIQUlOX0NPREVfTEVOR1RIID0gNjQ7XG5cbi8qKiBUb3RhbCBsZW5ndGggb2YgYSB3ZWxsLWZvcm1lZCBjb21wb3NpdGUgcHViLiAqL1xuZXhwb3J0IGNvbnN0IERFUklWQUJMRV9FRDI1NTE5X1BVQl9MRU5HVEggPSBERVJJVkFCTEVfRUQyNTUxOV9QVUJfU1BMSVRfT0ZGU0VUICsgREVSSVZBQkxFX0VEMjU1MTlfQ0hBSU5fQ09ERV9MRU5HVEg7XG5cbi8qKlxuICogQ2hhaW4gY29kZXMgYXJlIHNlcmlhbGl6ZWQgYXMgTE9XRVJDQVNFIGhleCBvbmx5LiBVcHBlcmNhc2UgYW5kIG1peGVkLWNhc2UgYXJlIHJlamVjdGVkIHJhdGhlclxuICogdGhhbiBub3JtYWxpemVkOiBhY2NlcHRpbmcgYm90aCBjYXNpbmdzIHdvdWxkIG1ha2UgdGhlIGNvbXBvc2l0ZSBwdWIgbm9uLWNhbm9uaWNhbCwgc28gdGhlIHNhbWVcbiAqIGtleSBjb3VsZCBiZSBzdG9yZWQgdW5kZXIgdHdvIGRpc3RpbmN0IHN0cmluZ3MgYW5kIGVxdWFsaXR5IGFnYWluc3QgYSBwcmV2aW91c2x5LXBlcnNpc3RlZCBwdWJcbiAqIHdvdWxkIHNwdXJpb3VzbHkgZmFpbC5cbiAqL1xuY29uc3QgQ0hBSU5fQ09ERV9SRUdFWCA9IC9eWzAtOWEtZl17NjR9JC87XG5cbi8qKiBTdHJLZXkgdmVyc2lvbiBieXRlIGZvciBhbiBlZDI1NTE5IHB1YmxpYyBrZXkgKGBH4oCmYCkuICovXG5jb25zdCBTVFJLRVlfVkVSU0lPTl9CWVRFX0VEMjU1MTlfUFVCTElDX0tFWSA9IDYgPDwgMztcblxuLyoqIERlY29kZWQgU3RyS2V5IHBheWxvYWQ6IDEgdmVyc2lvbiBieXRlICsgMzItYnl0ZSBrZXkgKyAyLWJ5dGUgY2hlY2tzdW0uICovXG5jb25zdCBTVFJLRVlfREVDT0RFRF9MRU5HVEggPSAzNTtcblxuY29uc3QgQkFTRTMyX0FMUEhBQkVUID0gJ0FCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaMjM0NTY3JztcbmNvbnN0IFNUUktFWV9FRDI1NTE5X1BVQkxJQ19LRVlfUkVHRVggPSAvXkdbQS1aMi03XXs1NX0kLztcblxuLyoqXG4gKiBEZWNvZGUgYW4gdW5wYWRkZWQgUkZDIDQ2NDggYmFzZTMyIHN0cmluZy4gVGhlIGNhbGxlciBndWFyYW50ZWVzIHRoZSBpbnB1dCBtYXRjaGVkXG4gKiB7QGxpbmsgU1RSS0VZX0VEMjU1MTlfUFVCTElDX0tFWV9SRUdFWH0sIHNvIDU2IGNoYXJzIMOXIDUgYml0cyA9IDI4MCBiaXRzID0gZXhhY3RseSAzNSBieXRlcyB3aXRoXG4gKiBubyBsZWZ0b3ZlciBiaXRzIOKAlCB0aGUgZW5jb2RpbmcgaXMgdW5hbWJpZ3VvdXNseSBjYW5vbmljYWwuXG4gKi9cbmZ1bmN0aW9uIGJhc2UzMkRlY29kZShpbnB1dDogc3RyaW5nKTogQnVmZmVyIHtcbiAgY29uc3Qgb3V0ID0gQnVmZmVyLmFsbG9jKChpbnB1dC5sZW5ndGggKiA1KSAvIDgpO1xuICBsZXQgYml0cyA9IDA7XG4gIGxldCB2YWx1ZSA9IDA7XG4gIGxldCBpbmRleCA9IDA7XG4gIGZvciAoY29uc3QgY2hhciBvZiBpbnB1dCkge1xuICAgIHZhbHVlID0gKHZhbHVlIDw8IDUpIHwgQkFTRTMyX0FMUEhBQkVULmluZGV4T2YoY2hhcik7XG4gICAgYml0cyArPSA1O1xuICAgIGlmIChiaXRzID49IDgpIHtcbiAgICAgIGJpdHMgLT0gODtcbiAgICAgIG91dFtpbmRleCsrXSA9ICh2YWx1ZSA+Pj4gYml0cykgJiAweGZmO1xuICAgIH1cbiAgfVxuICByZXR1cm4gb3V0O1xufVxuXG4vKiogQ1JDMTYtWE1vZGVtLCB0aGUgY2hlY2tzdW0gU3RlbGxhciBTdHJLZXkgYXBwZW5kcyAobGl0dGxlLWVuZGlhbikgdG8gdGhlIHZlcnNpb25lZCBwYXlsb2FkLiAqL1xuZnVuY3Rpb24gY3JjMTZYbW9kZW0oZGF0YTogQnVmZmVyKTogbnVtYmVyIHtcbiAgbGV0IGNyYyA9IDB4MDAwMDtcbiAgZm9yIChjb25zdCBieXRlIG9mIGRhdGEpIHtcbiAgICBsZXQgY29kZSA9IChjcmMgPj4+IDgpICYgMHhmZjtcbiAgICBjb2RlIF49IGJ5dGU7XG4gICAgY29kZSBePSBjb2RlID4+PiA0O1xuICAgIGNyYyA9ICgoY3JjIDw8IDgpICYgMHhmZmZmKSBeICgoY29kZSA8PCAxMikgJiAweGZmZmYpIF4gKChjb2RlIDw8IDUpICYgMHhmZmZmKSBeIGNvZGU7XG4gIH1cbiAgcmV0dXJuIGNyYyAmIDB4ZmZmZjtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRydWUgaWZmIGBwdWJgIGlzIGEgdmFsaWQgU3RlbGxhciBTdHJLZXkgZWQyNTUxOSBwdWJsaWMga2V5LlxuICpcbiAqIEltcGxlbWVudGVkIGhlcmUgcmF0aGVyIHRoYW4gcHVsbGVkIGZyb20gYHN0ZWxsYXItc2RrYCBiZWNhdXNlIGBzZGstY29yZWAgbXVzdCBub3QgZGVwZW5kIG9uIGFcbiAqIGNvaW4gbW9kdWxlLiBUaGUgcHViIGhhbGYgaXMgdmFsaWRhdGVkIGJ5IENIRUNLU1VNLCBub3QgbWVyZWx5IGJ5IGxlbmd0aCBhbmQgYWxwaGFiZXQg4oCUIGFcbiAqIDU2LWNoYXJhY3RlciBgR+KApmAgc3RyaW5nIHdpdGggYSBjb3JydXB0ZWQgYm9keSBpcyByZWplY3RlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzVmFsaWRFZDI1NTE5U3RyS2V5UHVibGljS2V5KHB1Yjogc3RyaW5nKTogYm9vbGVhbiB7XG4gIGlmICghU1RSS0VZX0VEMjU1MTlfUFVCTElDX0tFWV9SRUdFWC50ZXN0KHB1YikpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cbiAgY29uc3QgZGVjb2RlZCA9IGJhc2UzMkRlY29kZShwdWIpO1xuICBpZiAoZGVjb2RlZC5sZW5ndGggIT09IFNUUktFWV9ERUNPREVEX0xFTkdUSCB8fCBkZWNvZGVkWzBdICE9PSBTVFJLRVlfVkVSU0lPTl9CWVRFX0VEMjU1MTlfUFVCTElDX0tFWSkge1xuICAgIHJldHVybiBmYWxzZTtcbiAgfVxuICByZXR1cm4gKFxuICAgIGNyYzE2WG1vZGVtKGRlY29kZWQuc3ViYXJyYXkoMCwgU1RSS0VZX0RFQ09ERURfTEVOR1RIIC0gMikpID09PSBkZWNvZGVkLnJlYWRVSW50MTZMRShTVFJLRVlfREVDT0RFRF9MRU5HVEggLSAyKVxuICApO1xufVxuXG4vKiogUmV0dXJucyB0cnVlIGlmZiBgY2hhaW5Db2RlYCBpcyBleGFjdGx5IDY0IGxvd2VyY2FzZSBoZXggY2hhcmFjdGVycy4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1ZhbGlkRWQyNTUxOUNoYWluQ29kZShjaGFpbkNvZGU6IHN0cmluZyk6IGJvb2xlYW4ge1xuICByZXR1cm4gQ0hBSU5fQ09ERV9SRUdFWC50ZXN0KGNoYWluQ29kZSk7XG59XG5cbi8qKlxuICogQ29tcG9zZSBhIGRlcml2YWJsZSBzbG90LeKRoyByb290IHB1YiBmcm9tIGl0cyB0d28gaGFsdmVzLlxuICpcbiAqIFRocm93cyB3aGVuIGVpdGhlciBoYWxmIGlzIG1hbGZvcm1lZDogc2lsZW50bHkgZW1pdHRpbmcgYSBjb21wb3NpdGUgd2hvc2UgaGFsdmVzIGRvIG5vdCByb3VuZC10cmlwXG4gKiB3b3VsZCBwZXJzaXN0IGEgcm9vdCBwdWIgZnJvbSB3aGljaCBubyBjb3JyZWN0IGNvLXNpZ25lciBrZXkgY2FuIGV2ZXIgYmUgZGVyaXZlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVuY29kZURlcml2YWJsZUVkMjU1MTlQdWIocHViOiBzdHJpbmcsIGNoYWluQ29kZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgaWYgKCFpc1ZhbGlkRWQyNTUxOVN0cktleVB1YmxpY0tleShwdWIpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKCdJbnZhbGlkIGRlcml2YWJsZSBlZDI1NTE5IHB1YjogcHViIGhhbGYgaXMgbm90IGEgdmFsaWQgZWQyNTUxOSBwdWJsaWMga2V5Jyk7XG4gIH1cbiAgaWYgKCFpc1ZhbGlkRWQyNTUxOUNoYWluQ29kZShjaGFpbkNvZGUpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKCdJbnZhbGlkIGRlcml2YWJsZSBlZDI1NTE5IHB1YjogY2hhaW5Db2RlIG11c3QgYmUgNjQgbG93ZXJjYXNlIGhleCBjaGFyYWN0ZXJzJyk7XG4gIH1cbiAgcmV0dXJuIGAke3B1Yn0ke2NoYWluQ29kZX1gO1xufVxuXG4vKipcbiAqIFNwbGl0IGEgY29tcG9zaXRlIHNsb3Qt4pGjIHJvb3QgcHViIGJhY2sgaW50byBpdHMgdHdvIGhhbHZlcy5cbiAqXG4gKiBUaHJvd3MgdW5sZXNzIHRoZSBpbnB1dCBpcyBFWEFDVExZIHRoZSBjb21wb3NpdGUgZm9ybS4gQSBsZW5pZW50IGRlY29kZSB0aGF0IGFjY2VwdGVkIGEgYmFyZVxuICogNTYtY2hhcmFjdGVyIHB1YiB3b3VsZCBoYW5kIGNhbGxlcnMgYW4gZW1wdHkgY2hhaW4gY29kZSBhbmQgZGVyaXZlIGV2ZXJ5IGNvLXNpZ25lciBmcm9tIHRoZSBzYW1lXG4gKiAoemVyby1sZW5ndGgpIGVudHJvcHkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZWNvZGVEZXJpdmFibGVFZDI1NTE5UHViKGNvbXBvc2l0ZTogc3RyaW5nKTogeyBwdWI6IHN0cmluZzsgY2hhaW5Db2RlOiBzdHJpbmcgfSB7XG4gIGlmIChjb21wb3NpdGUubGVuZ3RoICE9PSBERVJJVkFCTEVfRUQyNTUxOV9QVUJfTEVOR1RIKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgYEludmFsaWQgZGVyaXZhYmxlIGVkMjU1MTkgcHViOiBleHBlY3RlZCAke0RFUklWQUJMRV9FRDI1NTE5X1BVQl9MRU5HVEh9IGNoYXJhY3RlcnMsIGdvdCAke2NvbXBvc2l0ZS5sZW5ndGh9YFxuICAgICk7XG4gIH1cbiAgY29uc3QgcHViID0gY29tcG9zaXRlLnNsaWNlKDAsIERFUklWQUJMRV9FRDI1NTE5X1BVQl9TUExJVF9PRkZTRVQpO1xuICBjb25zdCBjaGFpbkNvZGUgPSBjb21wb3NpdGUuc2xpY2UoREVSSVZBQkxFX0VEMjU1MTlfUFVCX1NQTElUX09GRlNFVCk7XG4gIGlmICghaXNWYWxpZEVkMjU1MTlTdHJLZXlQdWJsaWNLZXkocHViKSkge1xuICAgIHRocm93IG5ldyBFcnJvcignSW52YWxpZCBkZXJpdmFibGUgZWQyNTUxOSBwdWI6IHB1YiBoYWxmIGlzIG5vdCBhIHZhbGlkIGVkMjU1MTkgcHVibGljIGtleScpO1xuICB9XG4gIGlmICghaXNWYWxpZEVkMjU1MTlDaGFpbkNvZGUoY2hhaW5Db2RlKSkge1xuICAgIHRocm93IG5ldyBFcnJvcignSW52YWxpZCBkZXJpdmFibGUgZWQyNTUxOSBwdWI6IGNoYWluQ29kZSBtdXN0IGJlIDY0IGxvd2VyY2FzZSBoZXggY2hhcmFjdGVycycpO1xuICB9XG4gIHJldHVybiB7IHB1YiwgY2hhaW5Db2RlIH07XG59XG5cbi8qKiBSZXR1cm5zIHRydWUgaWZmIGBjb21wb3NpdGVgIGlzIGEgd2VsbC1mb3JtZWQgZGVyaXZhYmxlIHNsb3Qt4pGjIHJvb3QgcHViLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzRGVyaXZhYmxlRWQyNTUxOVB1Yihjb21wb3NpdGU6IHN0cmluZyk6IGJvb2xlYW4ge1xuICB0cnkge1xuICAgIGRlY29kZURlcml2YWJsZUVkMjU1MTlQdWIoY29tcG9zaXRlKTtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG59XG4iXX0=

package/dist/src/bitgo/safe/iSafe.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @prettier
+ *
+ * @experimental The safe client surface is experimental and may change (including breaking
+ * changes) before the public release.
+ */
+import type { FreezeSafeBody, SafeData, SafePermission, SafeRootKeys, SafeShareData, SafeShareKeychain, SafeShareState } from '@bitgo/public-types';
+import type { Wallet, WalletShare } from '../wallet';
+/** @experimental */
+export interface InitializeSafeOptions {
+    label: string;
+}
+/**
+ * Phase 3 — the client hands back the 12 key ids it created in Phase 2.
+ * @experimental
+ */
+export interface FinalizeSafeOptions {
+    rootKeys: SafeRootKeys;
+}
+/**
+ * Sharing ONE safe wallet with a non-member rides the existing wallet-share handshake (FR-13),
+ * so the result is the existing WalletShare shape.
+ */
+export type WalletShareData = WalletShare;
+export interface CreateSafeWalletOptions {
+    coin: string;
+    label: string;
+    passphrase: string;
+    type?: 'hot';
+    /** `tss` throws until MPC mint lands. Defaults to `onchain`. */
+    multisigType?: 'onchain' | 'tss';
+}
+interface AddSafeMemberBase {
+    permissions: SafePermission[];
+    /** required when 'spend' is included — the 4 root user keys ECDH-re-encrypted to the invitee */
+    keychains?: SafeShareKeychain[];
+    message?: string;
+    /** when true, suppress the invitation email that would otherwise be sent to `email` */
+    disableEmail?: boolean;
+}
+/** Add a member by either `userId` or `email` — exactly one is required. */
+export type AddSafeMemberOptions = (AddSafeMemberBase & {
+    userId: string;
+    email?: never;
+}) | (AddSafeMemberBase & {
+    email: string;
+    userId?: never;
+});
+export interface AddSafeWalletMemberOptions {
+    walletId: string;
+    /** required — sharing re-encrypts the user key, which needs hardened derivation from the passphrase */
+    walletPassphrase: string;
+    email?: string;
+    permissions?: string[];
+    message?: string;
+}
+export type AcceptSafeShareAsSpenderOptions = {
+    safeShareId: string;
+    userPassword: string;
+    newWalletPassphrase?: string;
+};
+export type AcceptSafeShareAsNonSpenderOptions = {
+    safeShareId: string;
+};
+export type AcceptSafeShareOptions = AcceptSafeShareAsSpenderOptions | AcceptSafeShareAsNonSpenderOptions;
+/**
+ * @experimental
+ */
+export interface ISafe {
+    id(): string;
+    enterpriseId(): string;
+    label(): string;
+    status(): SafeData['status'];
+    url(extra?: string): string;
+    createWallet(params: CreateSafeWalletOptions): Promise<Wallet>;
+    addMember(params: AddSafeMemberOptions): Promise<SafeData>;
+    addMemberToWallet(params: AddSafeWalletMemberOptions): Promise<WalletShareData>;
+    listShares(params?: {
+        state?: SafeShareState;
+    }): Promise<SafeShareData[]>;
+    acceptShare(params: AcceptSafeShareOptions): Promise<SafeShareData>;
+    freeze(params?: FreezeSafeBody): Promise<SafeData>;
+    archive(): Promise<SafeData>;
+    toJSON(): SafeData;
+}
+export {};
+//# sourceMappingURL=iSafe.d.ts.map

package/dist/src/bitgo/safe/iSafe.d.ts.map

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

package/dist/src/bitgo/safe/iSafe.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaVNhZmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYml0Z28vc2FmZS9pU2FmZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAcHJldHRpZXJcbiAqXG4gKiBAZXhwZXJpbWVudGFsIFRoZSBzYWZlIGNsaWVudCBzdXJmYWNlIGlzIGV4cGVyaW1lbnRhbCBhbmQgbWF5IGNoYW5nZSAoaW5jbHVkaW5nIGJyZWFraW5nXG4gKiBjaGFuZ2VzKSBiZWZvcmUgdGhlIHB1YmxpYyByZWxlYXNlLlxuICovXG4vLyBXaXJlL2RhdGEgc2hhcGVzIGFyZSBvd25lZCBieSBAYml0Z28vcHVibGljLXR5cGVzIOKAlCBpbXBvcnQgdGhlbSB3aGVyZSBuZWVkZWQgcmF0aGVyIHRoYW5cbi8vIHJlLWV4cG9ydGluZyBmcm9tIHNkay1jb3JlLlxuaW1wb3J0IHR5cGUge1xuICBGcmVlemVTYWZlQm9keSxcbiAgU2FmZURhdGEsXG4gIFNhZmVQZXJtaXNzaW9uLFxuICBTYWZlUm9vdEtleXMsXG4gIFNhZmVTaGFyZURhdGEsXG4gIFNhZmVTaGFyZUtleWNoYWluLFxuICBTYWZlU2hhcmVTdGF0ZSxcbn0gZnJvbSAnQGJpdGdvL3B1YmxpYy10eXBlcyc7XG5pbXBvcnQgdHlwZSB7IFdhbGxldCwgV2FsbGV0U2hhcmUgfSBmcm9tICcuLi93YWxsZXQnO1xuXG4vKiogQGV4cGVyaW1lbnRhbCAqL1xuZXhwb3J0IGludGVyZmFjZSBJbml0aWFsaXplU2FmZU9wdGlvbnMge1xuICBsYWJlbDogc3RyaW5nO1xufVxuXG4vKipcbiAqIFBoYXNlIDMg4oCUIHRoZSBjbGllbnQgaGFuZHMgYmFjayB0aGUgMTIga2V5IGlkcyBpdCBjcmVhdGVkIGluIFBoYXNlIDIuXG4gKiBAZXhwZXJpbWVudGFsXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRmluYWxpemVTYWZlT3B0aW9ucyB7XG4gIHJvb3RLZXlzOiBTYWZlUm9vdEtleXM7XG59XG5cbi8qKlxuICogU2hhcmluZyBPTkUgc2FmZSB3YWxsZXQgd2l0aCBhIG5vbi1tZW1iZXIgcmlkZXMgdGhlIGV4aXN0aW5nIHdhbGxldC1zaGFyZSBoYW5kc2hha2UgKEZSLTEzKSxcbiAqIHNvIHRoZSByZXN1bHQgaXMgdGhlIGV4aXN0aW5nIFdhbGxldFNoYXJlIHNoYXBlLlxuICovXG5leHBvcnQgdHlwZSBXYWxsZXRTaGFyZURhdGEgPSBXYWxsZXRTaGFyZTtcblxuLy8gLS0tLSBwZXItc2FmZSBvcGVyYXRpb24gb3B0aW9ucyAtLS0tXG5cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlU2FmZVdhbGxldE9wdGlvbnMge1xuICBjb2luOiBzdHJpbmc7XG4gIGxhYmVsOiBzdHJpbmc7XG4gIHBhc3NwaHJhc2U6IHN0cmluZztcbiAgdHlwZT86ICdob3QnO1xuICAvKiogYHRzc2AgdGhyb3dzIHVudGlsIE1QQyBtaW50IGxhbmRzLiBEZWZhdWx0cyB0byBgb25jaGFpbmAuICovXG4gIG11bHRpc2lnVHlwZT86ICdvbmNoYWluJyB8ICd0c3MnO1xufVxuXG5pbnRlcmZhY2UgQWRkU2FmZU1lbWJlckJhc2Uge1xuICBwZXJtaXNzaW9uczogU2FmZVBlcm1pc3Npb25bXTtcbiAgLyoqIHJlcXVpcmVkIHdoZW4gJ3NwZW5kJyBpcyBpbmNsdWRlZCDigJQgdGhlIDQgcm9vdCB1c2VyIGtleXMgRUNESC1yZS1lbmNyeXB0ZWQgdG8gdGhlIGludml0ZWUgKi9cbiAga2V5Y2hhaW5zPzogU2FmZVNoYXJlS2V5Y2hhaW5bXTtcbiAgbWVzc2FnZT86IHN0cmluZztcbiAgLyoqIHdoZW4gdHJ1ZSwgc3VwcHJlc3MgdGhlIGludml0YXRpb24gZW1haWwgdGhhdCB3b3VsZCBvdGhlcndpc2UgYmUgc2VudCB0byBgZW1haWxgICovXG4gIGRpc2FibGVFbWFpbD86IGJvb2xlYW47XG59XG5cbi8qKiBBZGQgYSBtZW1iZXIgYnkgZWl0aGVyIGB1c2VySWRgIG9yIGBlbWFpbGAg4oCUIGV4YWN0bHkgb25lIGlzIHJlcXVpcmVkLiAqL1xuZXhwb3J0IHR5cGUgQWRkU2FmZU1lbWJlck9wdGlvbnMgPVxuICB8IChBZGRTYWZlTWVtYmVyQmFzZSAmIHsgdXNlcklkOiBzdHJpbmc7IGVtYWlsPzogbmV2ZXIgfSlcbiAgfCAoQWRkU2FmZU1lbWJlckJhc2UgJiB7IGVtYWlsOiBzdHJpbmc7IHVzZXJJZD86IG5ldmVyIH0pO1xuXG5leHBvcnQgaW50ZXJmYWNlIEFkZFNhZmVXYWxsZXRNZW1iZXJPcHRpb25zIHtcbiAgd2FsbGV0SWQ6IHN0cmluZztcbiAgLyoqIHJlcXVpcmVkIOKAlCBzaGFyaW5nIHJlLWVuY3J5cHRzIHRoZSB1c2VyIGtleSwgd2hpY2ggbmVlZHMgaGFyZGVuZWQgZGVyaXZhdGlvbiBmcm9tIHRoZSBwYXNzcGhyYXNlICovXG4gIHdhbGxldFBhc3NwaHJhc2U6IHN0cmluZztcbiAgZW1haWw/OiBzdHJpbmc7XG4gIHBlcm1pc3Npb25zPzogc3RyaW5nW107XG4gIG1lc3NhZ2U/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCB0eXBlIEFjY2VwdFNhZmVTaGFyZUFzU3BlbmRlck9wdGlvbnMgPSB7XG4gIHNhZmVTaGFyZUlkOiBzdHJpbmc7XG4gIHVzZXJQYXNzd29yZDogc3RyaW5nO1xuICBuZXdXYWxsZXRQYXNzcGhyYXNlPzogc3RyaW5nO1xufTtcbmV4cG9ydCB0eXBlIEFjY2VwdFNhZmVTaGFyZUFzTm9uU3BlbmRlck9wdGlvbnMgPSB7XG4gIHNhZmVTaGFyZUlkOiBzdHJpbmc7XG59O1xuZXhwb3J0IHR5cGUgQWNjZXB0U2FmZVNoYXJlT3B0aW9ucyA9IEFjY2VwdFNhZmVTaGFyZUFzU3BlbmRlck9wdGlvbnMgfCBBY2NlcHRTYWZlU2hhcmVBc05vblNwZW5kZXJPcHRpb25zO1xuXG4vKipcbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJU2FmZSB7XG4gIGlkKCk6IHN0cmluZztcbiAgZW50ZXJwcmlzZUlkKCk6IHN0cmluZztcbiAgbGFiZWwoKTogc3RyaW5nO1xuICBzdGF0dXMoKTogU2FmZURhdGFbJ3N0YXR1cyddO1xuICB1cmwoZXh0cmE/OiBzdHJpbmcpOiBzdHJpbmc7XG4gIGNyZWF0ZVdhbGxldChwYXJhbXM6IENyZWF0ZVNhZmVXYWxsZXRPcHRpb25zKTogUHJvbWlzZTxXYWxsZXQ+O1xuICAvLyB3aG9sZS1zYWZlOiB2aWV3L2FkbWluL3NwZW5kL2RhcHA7IHNwZW5kIG9wZW5zIGEga2V5IHNoYXJlIChhbHNvIGhvdyBhIHNwZW5kZXIgc2VydmljZXMgYVxuICAvLyBzYWZlU2hhcmVSZXF1ZXN0cyBlbnRyeSBpbiBVTVMgb3JncylcbiAgYWRkTWVtYmVyKHBhcmFtczogQWRkU2FmZU1lbWJlck9wdGlvbnMpOiBQcm9taXNlPFNhZmVEYXRhPjtcbiAgLy8gc2hhcmUgT05FIHNhZmUgd2FsbGV0LCBub3QgdGhlIHdob2xlIHNhZmVcbiAgYWRkTWVtYmVyVG9XYWxsZXQocGFyYW1zOiBBZGRTYWZlV2FsbGV0TWVtYmVyT3B0aW9ucyk6IFByb21pc2U8V2FsbGV0U2hhcmVEYXRhPjtcbiAgbGlzdFNoYXJlcyhwYXJhbXM/OiB7IHN0YXRlPzogU2FmZVNoYXJlU3RhdGUgfSk6IFByb21pc2U8U2FmZVNoYXJlRGF0YVtdPjtcbiAgYWNjZXB0U2hhcmUocGFyYW1zOiBBY2NlcHRTYWZlU2hhcmVPcHRpb25zKTogUHJvbWlzZTxTYWZlU2hhcmVEYXRhPjtcbiAgZnJlZXplKHBhcmFtcz86IEZyZWV6ZVNhZmVCb2R5KTogUHJvbWlzZTxTYWZlRGF0YT47XG4gIGFyY2hpdmUoKTogUHJvbWlzZTxTYWZlRGF0YT47XG4gIHRvSlNPTigpOiBTYWZlRGF0YTtcbn1cbiJdfQ==

package/dist/src/bitgo/safe/iSafes.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @prettier
+ *
+ * @experimental The safe client surface is experimental and may change (including breaking
+ * changes) before the public release.
+ */
+import type { InitializeSafeResponse } from '@bitgo/public-types';
+import { FinalizeSafeOptions, InitializeSafeOptions } from './iSafe';
+import { Safe } from './safe';
+/**
+ * Options for safe creation.
+ *
+ * v1 targets the HOT custody model only: the multisig root user/backup keys are generated locally
+ * by the SDK, encrypted with `passphrase`, and registered on BitGo; the MPC roots run the standard
+ * hot ceremonies with the same passphrase. Self-managed cold keys and custodial safes are out of
+ * scope for v1.
+ * @experimental
+ */
+export interface CreateSafeOptions {
+    label: string;
+    passphrase: string;
+}
+/**
+ * Handle returned by `initializeSafe`, threaded into the key ceremonies and finalize.
+ *
+ * `enabledRootSlots` is the server-decided (Flipt, evaluated once at initialize) set of root-key
+ * slots to generate; absent (older WP) falls back to all 4 slots.
+ * @experimental
+ */
+export interface SafeCreationHandle {
+    safeId: string;
+    enabledRootSlots?: InitializeSafeResponse['enabledRootSlots'];
+}
+/**
+ * The minted root key ids produced by `createSafeKeys`, as ordered [user, backup, bitgo]
+ * triplets for the enabled slots — exactly the payload `finalizeSafe` consumes.
+ * @experimental
+ */
+export type SafeKeys = FinalizeSafeOptions;
+/**
+ * @experimental
+ */
+export interface ListSafesOptions {
+    cursor?: string;
+    limit?: number;
+}
+/**
+ * @experimental
+ */
+export interface GetSafeOptions {
+    id: string;
+}
+/**
+ * @experimental
+ */
+export interface ISafes {
+    /**
+     * One-call convenience wrapper chaining the three creation phases:
+     * initialize → createSafeKeys (safeId-tagged ceremonies for the enabled root slots) → finalize.
+     * HOT custody only in v1.
+     * @experimental
+     */
+    generateSafe(params: CreateSafeOptions): Promise<Safe>;
+    /**
+     * Phase 1 — initialize a safe (metadata only, no key material). The server response is
+     * `{ id, status }` plus optional `enabledRootSlots` (no `label`/`enterpriseId`/`creator`/`users`/
+     * `createdAt` yet), so this returns that raw shape rather than a full `Safe`.
+     * @experimental
+     */
+    initializeSafe(params: InitializeSafeOptions): Promise<InitializeSafeResponse>;
+    /**
+     * Phase 2 — run the enabled root key ceremonies tagged with `safeId`; returns the minted key ids.
+     * @experimental
+     */
+    createSafeKeys(params: CreateSafeOptions & SafeCreationHandle): Promise<SafeKeys>;
+    /**
+     * Phase 3 — finalize a safe with the minted root key ids. Idempotent.
+     * @experimental
+     */
+    finalizeSafe(safeId: string, params: FinalizeSafeOptions): Promise<Safe>;
+    /**
+     * Archive a safe. Also the abandonment path for a stuck `initializing` safe.
+     * @experimental
+     */
+    archiveSafe(safeId: string): Promise<Safe>;
+    /** @experimental */
+    list(params?: ListSafesOptions): Promise<{
+        safes: Safe[];
+        nextCursor?: string;
+    }>;
+    /** @experimental */
+    get(params: GetSafeOptions): Promise<Safe>;
+}
+//# sourceMappingURL=iSafes.d.ts.map

package/dist/src/bitgo/safe/iSafes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iSafes.d.ts","sourceRoot":"","sources":["../../../../src/bitgo/safe/iSafes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/E;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,oBAAoB;IACpB,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,oBAAoB;IACpB,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/src/bitgo/safe/iSafes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaVNhZmVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2JpdGdvL3NhZmUvaVNhZmVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBwcmV0dGllclxuICpcbiAqIEBleHBlcmltZW50YWwgVGhlIHNhZmUgY2xpZW50IHN1cmZhY2UgaXMgZXhwZXJpbWVudGFsIGFuZCBtYXkgY2hhbmdlIChpbmNsdWRpbmcgYnJlYWtpbmdcbiAqIGNoYW5nZXMpIGJlZm9yZSB0aGUgcHVibGljIHJlbGVhc2UuXG4gKi9cbmltcG9ydCB0eXBlIHsgSW5pdGlhbGl6ZVNhZmVSZXNwb25zZSB9IGZyb20gJ0BiaXRnby9wdWJsaWMtdHlwZXMnO1xuaW1wb3J0IHsgRmluYWxpemVTYWZlT3B0aW9ucywgSW5pdGlhbGl6ZVNhZmVPcHRpb25zIH0gZnJvbSAnLi9pU2FmZSc7XG5pbXBvcnQgeyBTYWZlIH0gZnJvbSAnLi9zYWZlJztcblxuLyoqXG4gKiBPcHRpb25zIGZvciBzYWZlIGNyZWF0aW9uLlxuICpcbiAqIHYxIHRhcmdldHMgdGhlIEhPVCBjdXN0b2R5IG1vZGVsIG9ubHk6IHRoZSBtdWx0aXNpZyByb290IHVzZXIvYmFja3VwIGtleXMgYXJlIGdlbmVyYXRlZCBsb2NhbGx5XG4gKiBieSB0aGUgU0RLLCBlbmNyeXB0ZWQgd2l0aCBgcGFzc3BocmFzZWAsIGFuZCByZWdpc3RlcmVkIG9uIEJpdEdvOyB0aGUgTVBDIHJvb3RzIHJ1biB0aGUgc3RhbmRhcmRcbiAqIGhvdCBjZXJlbW9uaWVzIHdpdGggdGhlIHNhbWUgcGFzc3BocmFzZS4gU2VsZi1tYW5hZ2VkIGNvbGQga2V5cyBhbmQgY3VzdG9kaWFsIHNhZmVzIGFyZSBvdXQgb2ZcbiAqIHNjb3BlIGZvciB2MS5cbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDcmVhdGVTYWZlT3B0aW9ucyB7XG4gIGxhYmVsOiBzdHJpbmc7XG4gIHBhc3NwaHJhc2U6IHN0cmluZzsgLy8gZW5jcnlwdHMgdGhlIGxvY2FsbHktZ2VuZXJhdGVkIG11bHRpc2lnIHVzZXIvYmFja3VwIHBydnM7IHNoYXJlZCB3aXRoIHRoZSBNUEMgY2VyZW1vbmllc1xufVxuXG4vKipcbiAqIEhhbmRsZSByZXR1cm5lZCBieSBgaW5pdGlhbGl6ZVNhZmVgLCB0aHJlYWRlZCBpbnRvIHRoZSBrZXkgY2VyZW1vbmllcyBhbmQgZmluYWxpemUuXG4gKlxuICogYGVuYWJsZWRSb290U2xvdHNgIGlzIHRoZSBzZXJ2ZXItZGVjaWRlZCAoRmxpcHQsIGV2YWx1YXRlZCBvbmNlIGF0IGluaXRpYWxpemUpIHNldCBvZiByb290LWtleVxuICogc2xvdHMgdG8gZ2VuZXJhdGU7IGFic2VudCAob2xkZXIgV1ApIGZhbGxzIGJhY2sgdG8gYWxsIDQgc2xvdHMuXG4gKiBAZXhwZXJpbWVudGFsXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2FmZUNyZWF0aW9uSGFuZGxlIHtcbiAgc2FmZUlkOiBzdHJpbmc7XG4gIGVuYWJsZWRSb290U2xvdHM/OiBJbml0aWFsaXplU2FmZVJlc3BvbnNlWydlbmFibGVkUm9vdFNsb3RzJ107XG59XG5cbi8qKlxuICogVGhlIG1pbnRlZCByb290IGtleSBpZHMgcHJvZHVjZWQgYnkgYGNyZWF0ZVNhZmVLZXlzYCwgYXMgb3JkZXJlZCBbdXNlciwgYmFja3VwLCBiaXRnb11cbiAqIHRyaXBsZXRzIGZvciB0aGUgZW5hYmxlZCBzbG90cyDigJQgZXhhY3RseSB0aGUgcGF5bG9hZCBgZmluYWxpemVTYWZlYCBjb25zdW1lcy5cbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IHR5cGUgU2FmZUtleXMgPSBGaW5hbGl6ZVNhZmVPcHRpb25zO1xuXG4vKipcbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBMaXN0U2FmZXNPcHRpb25zIHtcbiAgY3Vyc29yPzogc3RyaW5nOyAvLyBvcGFxdWUgY3Vyc29yIGZyb20gYSBwcmV2aW91cyByZXNwb25zZSdzIG5leHRDdXJzb3JcbiAgbGltaXQ/OiBudW1iZXI7XG59XG5cbi8qKlxuICogQGV4cGVyaW1lbnRhbFxuICovXG5leHBvcnQgaW50ZXJmYWNlIEdldFNhZmVPcHRpb25zIHtcbiAgaWQ6IHN0cmluZztcbn1cblxuLyoqXG4gKiBAZXhwZXJpbWVudGFsXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSVNhZmVzIHtcbiAgLyoqXG4gICAqIE9uZS1jYWxsIGNvbnZlbmllbmNlIHdyYXBwZXIgY2hhaW5pbmcgdGhlIHRocmVlIGNyZWF0aW9uIHBoYXNlczpcbiAgICogaW5pdGlhbGl6ZSDihpIgY3JlYXRlU2FmZUtleXMgKHNhZmVJZC10YWdnZWQgY2VyZW1vbmllcyBmb3IgdGhlIGVuYWJsZWQgcm9vdCBzbG90cykg4oaSIGZpbmFsaXplLlxuICAgKiBIT1QgY3VzdG9keSBvbmx5IGluIHYxLlxuICAgKiBAZXhwZXJpbWVudGFsXG4gICAqL1xuICBnZW5lcmF0ZVNhZmUocGFyYW1zOiBDcmVhdGVTYWZlT3B0aW9ucyk6IFByb21pc2U8U2FmZT47XG4gIC8qKlxuICAgKiBQaGFzZSAxIOKAlCBpbml0aWFsaXplIGEgc2FmZSAobWV0YWRhdGEgb25seSwgbm8ga2V5IG1hdGVyaWFsKS4gVGhlIHNlcnZlciByZXNwb25zZSBpc1xuICAgKiBgeyBpZCwgc3RhdHVzIH1gIHBsdXMgb3B0aW9uYWwgYGVuYWJsZWRSb290U2xvdHNgIChubyBgbGFiZWxgL2BlbnRlcnByaXNlSWRgL2BjcmVhdG9yYC9gdXNlcnNgL1xuICAgKiBgY3JlYXRlZEF0YCB5ZXQpLCBzbyB0aGlzIHJldHVybnMgdGhhdCByYXcgc2hhcGUgcmF0aGVyIHRoYW4gYSBmdWxsIGBTYWZlYC5cbiAgICogQGV4cGVyaW1lbnRhbFxuICAgKi9cbiAgaW5pdGlhbGl6ZVNhZmUocGFyYW1zOiBJbml0aWFsaXplU2FmZU9wdGlvbnMpOiBQcm9taXNlPEluaXRpYWxpemVTYWZlUmVzcG9uc2U+O1xuICAvKipcbiAgICogUGhhc2UgMiDigJQgcnVuIHRoZSBlbmFibGVkIHJvb3Qga2V5IGNlcmVtb25pZXMgdGFnZ2VkIHdpdGggYHNhZmVJZGA7IHJldHVybnMgdGhlIG1pbnRlZCBrZXkgaWRzLlxuICAgKiBAZXhwZXJpbWVudGFsXG4gICAqL1xuICBjcmVhdGVTYWZlS2V5cyhwYXJhbXM6IENyZWF0ZVNhZmVPcHRpb25zICYgU2FmZUNyZWF0aW9uSGFuZGxlKTogUHJvbWlzZTxTYWZlS2V5cz47XG4gIC8qKlxuICAgKiBQaGFzZSAzIOKAlCBmaW5hbGl6ZSBhIHNhZmUgd2l0aCB0aGUgbWludGVkIHJvb3Qga2V5IGlkcy4gSWRlbXBvdGVudC5cbiAgICogQGV4cGVyaW1lbnRhbFxuICAgKi9cbiAgZmluYWxpemVTYWZlKHNhZmVJZDogc3RyaW5nLCBwYXJhbXM6IEZpbmFsaXplU2FmZU9wdGlvbnMpOiBQcm9taXNlPFNhZmU+O1xuICAvKipcbiAgICogQXJjaGl2ZSBhIHNhZmUuIEFsc28gdGhlIGFiYW5kb25tZW50IHBhdGggZm9yIGEgc3R1Y2sgYGluaXRpYWxpemluZ2Agc2FmZS5cbiAgICogQGV4cGVyaW1lbnRhbFxuICAgKi9cbiAgYXJjaGl2ZVNhZmUoc2FmZUlkOiBzdHJpbmcpOiBQcm9taXNlPFNhZmU+O1xuICAvKiogQGV4cGVyaW1lbnRhbCAqL1xuICBsaXN0KHBhcmFtcz86IExpc3RTYWZlc09wdGlvbnMpOiBQcm9taXNlPHsgc2FmZXM6IFNhZmVbXTsgbmV4dEN1cnNvcj86IHN0cmluZyB9PjtcbiAgLyoqIEBleHBlcmltZW50YWwgKi9cbiAgZ2V0KHBhcmFtczogR2V0U2FmZU9wdGlvbnMpOiBQcm9taXNlPFNhZmU+O1xufVxuIl19

package/dist/src/bitgo/safe/index.d.ts

@@ -0,0 +1,7 @@
+export * from './derivableEd25519Pub';
+export * from './iSafe';
+export * from './iSafes';
+export * from './safe';
+export * from './safeDerivation';
+export * from './safes';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/bitgo/safe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bitgo/safe/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/src/bitgo/safe/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./derivableEd25519Pub"), exports);
+__exportStar(require("./iSafe"), exports);
+__exportStar(require("./iSafes"), exports);
+__exportStar(require("./safe"), exports);
+__exportStar(require("./safeDerivation"), exports);
+__exportStar(require("./safes"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYml0Z28vc2FmZS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsd0RBQXNDO0FBQ3RDLDBDQUF3QjtBQUN4QiwyQ0FBeUI7QUFDekIseUNBQXVCO0FBQ3ZCLG1EQUFpQztBQUNqQywwQ0FBd0IiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2Rlcml2YWJsZUVkMjU1MTlQdWInO1xuZXhwb3J0ICogZnJvbSAnLi9pU2FmZSc7XG5leHBvcnQgKiBmcm9tICcuL2lTYWZlcyc7XG5leHBvcnQgKiBmcm9tICcuL3NhZmUnO1xuZXhwb3J0ICogZnJvbSAnLi9zYWZlRGVyaXZhdGlvbic7XG5leHBvcnQgKiBmcm9tICcuL3NhZmVzJztcbiJdfQ==

package/dist/src/bitgo/safe/safe.d.ts

@@ -0,0 +1,61 @@
+import { FreezeSafeBody, SafeData, SafeShareData, SafeShareState } from '@bitgo/public-types';
+import { BitGoBase } from '../bitgoBase';
+import { Wallet } from '../wallet';
+import { AcceptSafeShareOptions, AddSafeMemberOptions, AddSafeWalletMemberOptions, CreateSafeWalletOptions, ISafe, WalletShareData } from './iSafe';
+/**
+ * @experimental
+ */
+export declare class Safe implements ISafe {
+    private readonly bitgo;
+    readonly _safe: SafeData;
+    constructor(bitgo: BitGoBase, safeData: SafeData);
+    id(): string;
+    enterpriseId(): string;
+    label(): string;
+    status(): SafeData['status'];
+    /**
+     * Enterprise-scoped v2 URL for this safe, e.g. /api/v2/enterprise/:eId/safes/:safeId
+     * @param extra
+     */
+    url(extra?: string): string;
+    /**
+     * Mint a child wallet: peek the sequential index, hardened-derive the user child,
+     * register it public-only, then mint. Backup and BitGo children are soft-derived on the server.
+     */
+    createWallet(params: CreateSafeWalletOptions): Promise<Wallet>;
+    private fetchSafeData;
+    /**
+     * Add a member to the whole safe (view/admin/spend). Spend opens a key share.
+     * Body lands in WCN-1204.
+     */
+    addMember(params: AddSafeMemberOptions): Promise<SafeData>;
+    /**
+     * Share ONE safe wallet with a non-member via the existing wallet-share handshake (FR-13).
+     * Body lands in WCN-1204.
+     */
+    addMemberToWallet(params: AddSafeWalletMemberOptions): Promise<WalletShareData>;
+    /**
+     * List the safe key shares visible to the caller.
+     * Body lands in WCN-1204.
+     */
+    listShares(params?: {
+        state?: SafeShareState;
+    }): Promise<SafeShareData[]>;
+    /**
+     * Accept a safe key share addressed to the caller.
+     * Body lands in WCN-1204.
+     */
+    acceptShare(params: AcceptSafeShareOptions): Promise<SafeShareData>;
+    /**
+     * Freeze the safe — blocks withdrawals on all safe wallets. Safe stays 'active'.
+     * @param params
+     */
+    freeze(params?: FreezeSafeBody): Promise<SafeData>;
+    /**
+     * Archive the safe. Requires every safe wallet to already be archived; also the abandonment
+     * path for a stuck 'initializing' safe.
+     */
+    archive(): Promise<SafeData>;
+    toJSON(): SafeData;
+}
+//# sourceMappingURL=safe.d.ts.map

package/dist/src/bitgo/safe/safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../../../src/bitgo/safe/safe.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAGhH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,EACL,eAAe,EAChB,MAAM,SAAS,CAAC;AA8CjB;;GAEG;AACH,qBAAa,IAAK,YAAW,KAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,SAAgB,KAAK,EAAE,QAAQ,CAAC;gBAEpB,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ;IAKhD,EAAE,IAAI,MAAM;IAIZ,YAAY,IAAI,MAAM;IAItB,KAAK,IAAI,MAAM;IAIf,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAI5B;;;OAGG;IACH,GAAG,CAAC,KAAK,SAAK,GAAG,MAAM;IAIvB;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;YAmEtD,aAAa;IAK3B;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhE;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IAIrF;;;OAGG;IACG,UAAU,CAAC,MAAM,GAAE;QAAE,KAAK,CAAC,EAAE,cAAc,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAInF;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzE;;;OAGG;IACG,MAAM,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK5D;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAKlC,MAAM,IAAI,QAAQ;CAGnB"}