@interest-protocol/blast-admin-sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @interest-protocol/blast-admin-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The admin package in the [Blast SDK monorepo](https://github.com/interest-protocol/blast-v2-sdk).
+
+```sh
+npm install @interest-protocol/blast-admin-sdk
+```
+
+See the repository README and docs for usage, development, and release guidance.

package/dist/events.d.ts

@@ -0,0 +1,67 @@
+import type { SuiEventPosition } from "@interest-protocol/blast-core/events";
+import type { SuiClientTypes } from "@mysten/sui/client";
+/**
+ * The `blast_admin::blast_admin_events` the ACL emits, in Move field order.
+ * The generic upgrade-custody and operational-version events belong to
+ * package upgrades, which the SDK leaves to publish tooling.
+ */
+export declare const aclEventBcs: {
+    AdminGranted: import("@mysten/sui/bcs").BcsStruct<{
+        admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+    }, string>;
+    AdminRevoked: import("@mysten/sui/bcs").BcsStruct<{
+        admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        roles: import("@mysten/sui/bcs").BcsType<string[], Iterable<string> & {
+            length: number;
+        }, `vector<${string}>`>;
+    }, string>;
+    AdminRoleGranted: import("@mysten/sui/bcs").BcsStruct<{
+        admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        role: import("@mysten/sui/bcs").BcsType<string, string, string>;
+    }, string>;
+    AdminRoleRevoked: import("@mysten/sui/bcs").BcsStruct<{
+        admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        role: import("@mysten/sui/bcs").BcsType<string, string, string>;
+    }, string>;
+    AdminDestroyed: import("@mysten/sui/bcs").BcsStruct<{
+        admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        roles: import("@mysten/sui/bcs").BcsType<string[], Iterable<string> & {
+            length: number;
+        }, `vector<${string}>`>;
+        was_active: import("@mysten/sui/bcs").BcsType<boolean, boolean, "bool">;
+    }, string>;
+    SuperAdminTransferStarted: import("@mysten/sui/bcs").BcsStruct<{
+        recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+        execute_after_ms: import("@mysten/sui/bcs").BcsType<bigint, bigint, "u64">;
+    }, string>;
+    SuperAdminTransferCancelled: import("@mysten/sui/bcs").BcsStruct<{
+        recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+        execute_after_ms: import("@mysten/sui/bcs").BcsType<bigint, bigint, "u64">;
+    }, string>;
+    SuperAdminTransferred: import("@mysten/sui/bcs").BcsStruct<{
+        previous_super_admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        new_super_admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+    }, string>;
+    SuperAdminCapDestroyed: import("@mysten/sui/bcs").BcsStruct<{
+        super_admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+    }, string>;
+};
+export type AclEventKind = keyof typeof aclEventBcs;
+export type AclEventPayloads = {
+    [Kind in AclEventKind]: ReturnType<(typeof aclEventBcs)[Kind]["parse"]>;
+};
+export type DecodedAclEvent = {
+    [Kind in AclEventKind]: {
+        source: "admin";
+        kind: Kind;
+        payload: AclEventPayloads[Kind];
+        sender: string;
+        position: SuiEventPosition;
+    };
+}[AclEventKind];
+/** Decodes one `<adminPackageId>::blast_admin_events::<Kind>` ACL event. */
+export declare function decodeAclEvent(event: SuiClientTypes.EventEntry, adminPackageId: string): DecodedAclEvent;
+export declare function aclEventId(event: DecodedAclEvent): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,YAAY;;;;IAIZ,YAAY;;;;;;IAIZ,gBAAgB;;;;IAIhB,gBAAgB;;;;IAIhB,cAAc;;;;;;;IAKd,yBAAyB;;;;IACzB,2BAA2B;;;;IAI3B,qBAAqB;;;;;IAKrB,sBAAsB;;;CAGvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,WAAW,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG;KAC5B,IAAI,IAAI,YAAY,GAAG,UAAU,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;KAC3B,IAAI,IAAI,YAAY,GAAG;QACtB,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC;QACX,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,gBAAgB,CAAC;KAC5B;CACF,CAAC,YAAY,CAAC,CAAC;AAEhB,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,CAAC,UAAU,EAChC,cAAc,EAAE,MAAM,GACrB,eAAe,CAkBjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEzD"}

package/dist/events.js

@@ -0,0 +1,66 @@
+import { addressBcs, moveTypeNameBcs, suiObjectIdBcs, u64Bcs, } from "@interest-protocol/blast-core/bcs";
+import { normalizeSuiEventPosition, suiEventId, } from "@interest-protocol/blast-core/events";
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeSuiAddress, parseStructTag } from "@mysten/sui/utils";
+const roles = bcs.vector(moveTypeNameBcs);
+const transfer = { recipient: addressBcs, execute_after_ms: u64Bcs };
+/**
+ * The `blast_admin::blast_admin_events` the ACL emits, in Move field order.
+ * The generic upgrade-custody and operational-version events belong to
+ * package upgrades, which the SDK leaves to publish tooling.
+ */
+export const aclEventBcs = {
+    AdminGranted: bcs.struct("AdminGranted", {
+        admin_cap_id: suiObjectIdBcs,
+        recipient: addressBcs,
+    }),
+    AdminRevoked: bcs.struct("AdminRevoked", {
+        admin_cap_id: suiObjectIdBcs,
+        roles,
+    }),
+    AdminRoleGranted: bcs.struct("AdminRoleGranted", {
+        admin_cap_id: suiObjectIdBcs,
+        role: moveTypeNameBcs,
+    }),
+    AdminRoleRevoked: bcs.struct("AdminRoleRevoked", {
+        admin_cap_id: suiObjectIdBcs,
+        role: moveTypeNameBcs,
+    }),
+    AdminDestroyed: bcs.struct("AdminDestroyed", {
+        admin_cap_id: suiObjectIdBcs,
+        roles,
+        was_active: bcs.bool(),
+    }),
+    SuperAdminTransferStarted: bcs.struct("SuperAdminTransferStarted", transfer),
+    SuperAdminTransferCancelled: bcs.struct("SuperAdminTransferCancelled", transfer),
+    SuperAdminTransferred: bcs.struct("SuperAdminTransferred", {
+        previous_super_admin_cap_id: suiObjectIdBcs,
+        new_super_admin_cap_id: suiObjectIdBcs,
+        recipient: addressBcs,
+    }),
+    SuperAdminCapDestroyed: bcs.struct("SuperAdminCapDestroyed", {
+        super_admin_cap_id: suiObjectIdBcs,
+    }),
+};
+/** Decodes one `<adminPackageId>::blast_admin_events::<Kind>` ACL event. */
+export function decodeAclEvent(event, adminPackageId) {
+    const tag = parseStructTag(event.eventType);
+    if (tag.address !== normalizeSuiAddress(adminPackageId) ||
+        tag.module !== "blast_admin_events" ||
+        tag.typeParams.length > 0 ||
+        !Object.hasOwn(aclEventBcs, tag.name)) {
+        throw new TypeError(`unexpected ACL event type ${event.eventType}`);
+    }
+    const kind = tag.name;
+    return {
+        source: "admin",
+        kind,
+        payload: aclEventBcs[kind].parse(event.bcs),
+        sender: normalizeSuiAddress(event.sender),
+        position: normalizeSuiEventPosition(event),
+    };
+}
+export function aclEventId(event) {
+    return suiEventId(event.position);
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,MAAM,GACP,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,UAAU,GACX,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAC1C,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE;QACvC,YAAY,EAAE,cAAc;QAC5B,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE;QACvC,YAAY,EAAE,cAAc;QAC5B,KAAK;KACN,CAAC;IACF,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC/C,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,eAAe;KACtB,CAAC;IACF,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC/C,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,eAAe;KACtB,CAAC;IACF,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE;QAC3C,YAAY,EAAE,cAAc;QAC5B,KAAK;QACL,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE;KACvB,CAAC;IACF,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC,2BAA2B,EAAE,QAAQ,CAAC;IAC5E,2BAA2B,EAAE,GAAG,CAAC,MAAM,CACrC,6BAA6B,EAC7B,QAAQ,CACT;IACD,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,uBAAuB,EAAE;QACzD,2BAA2B,EAAE,cAAc;QAC3C,sBAAsB,EAAE,cAAc;QACtC,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,wBAAwB,EAAE;QAC3D,kBAAkB,EAAE,cAAc;KACnC,CAAC;CACH,CAAC;AAkBF,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,KAAgC,EAChC,cAAsB;IAEtB,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,IACE,GAAG,CAAC,OAAO,KAAK,mBAAmB,CAAC,cAAc,CAAC;QACnD,GAAG,CAAC,MAAM,KAAK,oBAAoB;QACnC,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,EACrC,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,6BAA6B,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAoB,CAAC;IACtC,OAAO;QACL,MAAM,EAAE,OAAO;QACf,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QAC3C,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC;QACzC,QAAQ,EAAE,yBAAyB,CAAC,KAAK,CAAC;KACxB,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,OAAO,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./events.ts";
+export * from "./reducer.ts";
+export * from "./state.ts";
+export * from "./transactions.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./events.js";
+export * from "./reducer.js";
+export * from "./state.js";
+export * from "./transactions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/reducer.d.ts

@@ -0,0 +1,19 @@
+import type { AclEventKind, DecodedAclEvent } from "./events.ts";
+import type { PendingSuperAdmin } from "./state.ts";
+/**
+ * The ACL rebuilt from its events. Its `init` emits nothing, so
+ * `superAdminCapId` stays null until the first accepted transfer; the publish
+ * effects name the first root. `admins` matches `AclState.admins` once every
+ * event is applied.
+ */
+export type AclProjection = {
+    appliedEventIds: Readonly<Record<string, true>>;
+    eventCounts: Readonly<Record<AclEventKind, number>>;
+    superAdminCapId: string | null;
+    admins: Readonly<Record<string, readonly string[]>>;
+    pendingSuperAdmin: PendingSuperAdmin | null;
+};
+export declare function createAclProjection(): AclProjection;
+/** Applies one event once; replaying an applied event returns `state` unchanged. */
+export declare function reduceAclEvent(state: AclProjection, event: DecodedAclEvent): AclProjection;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../src/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACpD,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,aAAa,CAUnD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,eAAe,GACrB,aAAa,CAkDf"}

package/dist/reducer.js

@@ -0,0 +1,67 @@
+import { aclEventBcs, aclEventId } from "./events.js";
+export function createAclProjection() {
+    return {
+        appliedEventIds: {},
+        eventCounts: Object.fromEntries(Object.keys(aclEventBcs).map((kind) => [kind, 0])),
+        superAdminCapId: null,
+        admins: {},
+        pendingSuperAdmin: null,
+    };
+}
+/** Applies one event once; replaying an applied event returns `state` unchanged. */
+export function reduceAclEvent(state, event) {
+    const eventId = aclEventId(event);
+    if (state.appliedEventIds[eventId])
+        return state;
+    const next = {
+        ...state,
+        appliedEventIds: { ...state.appliedEventIds, [eventId]: true },
+        eventCounts: {
+            ...state.eventCounts,
+            [event.kind]: state.eventCounts[event.kind] + 1,
+        },
+    };
+    switch (event.kind) {
+        case "AdminGranted":
+            return withRoles(next, event.payload.admin_cap_id, []);
+        case "AdminRevoked":
+        case "AdminDestroyed":
+            return withRoles(next, event.payload.admin_cap_id, null);
+        case "AdminRoleGranted": {
+            const { admin_cap_id, role } = event.payload;
+            const roles = next.admins[admin_cap_id] ?? [];
+            return withRoles(next, admin_cap_id, [...roles, role]);
+        }
+        case "AdminRoleRevoked": {
+            const { admin_cap_id, role } = event.payload;
+            const roles = next.admins[admin_cap_id] ?? [];
+            return withRoles(next, admin_cap_id, roles.filter((held) => held !== role));
+        }
+        case "SuperAdminTransferStarted":
+            return {
+                ...next,
+                pendingSuperAdmin: {
+                    recipient: event.payload.recipient,
+                    executeAfterMs: event.payload.execute_after_ms,
+                },
+            };
+        case "SuperAdminTransferCancelled":
+            return { ...next, pendingSuperAdmin: null };
+        case "SuperAdminTransferred":
+            return {
+                ...next,
+                superAdminCapId: event.payload.new_super_admin_cap_id,
+                pendingSuperAdmin: null,
+            };
+        case "SuperAdminCapDestroyed":
+            return next;
+    }
+}
+function withRoles(state, adminCapId, roles) {
+    const { [adminCapId]: _, ...admins } = state.admins;
+    return {
+        ...state,
+        admins: roles === null ? admins : { ...admins, [adminCapId]: roles },
+    };
+}
+//# sourceMappingURL=reducer.js.map

package/dist/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../src/reducer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiBtD,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,eAAe,EAAE,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAClB;QACjC,eAAe,EAAE,IAAI;QACrB,MAAM,EAAE,EAAE;QACV,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAC5B,KAAoB,EACpB,KAAsB;IAEtB,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,IAAI,GAAkB;QAC1B,GAAG,KAAK;QACR,eAAe,EAAE,EAAE,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;QAC9D,WAAW,EAAE;YACX,GAAG,KAAK,CAAC,WAAW;YACpB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;SAChD;KACF,CAAC;IACF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc;YACjB,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACzD,KAAK,cAAc,CAAC;QACpB,KAAK,gBAAgB;YACnB,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAC3D,KAAK,kBAAkB,EAAE,CAAC;YACxB,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,kBAAkB,EAAE,CAAC;YACxB,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAC9C,OAAO,SAAS,CACd,IAAI,EACJ,YAAY,EACZ,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CACtC,CAAC;QACJ,CAAC;QACD,KAAK,2BAA2B;YAC9B,OAAO;gBACL,GAAG,IAAI;gBACP,iBAAiB,EAAE;oBACjB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;oBAClC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB;iBAC/C;aACF,CAAC;QACJ,KAAK,6BAA6B;YAChC,OAAO,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC9C,KAAK,uBAAuB;YAC1B,OAAO;gBACL,GAAG,IAAI;gBACP,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,sBAAsB;gBACrD,iBAAiB,EAAE,IAAI;aACxB,CAAC;QACJ,KAAK,wBAAwB;YAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,KAAoB,EACpB,UAAkB,EAClB,KAA+B;IAE/B,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IACpD,OAAO;QACL,GAAG,KAAK;QACR,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE;KACrE,CAAC;AACJ,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,42 @@
+import type { SharedObjectIdentity } from "@interest-protocol/blast-core/sui";
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+/** BCS layout of `blast_admin::blast_acl::ACL`. */
+export declare const aclBcs: import("@mysten/sui/bcs").BcsStruct<{
+    id: import("@mysten/sui/bcs").BcsStruct<{
+        id: import("@mysten/sui/bcs").BcsStruct<{
+            bytes: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+        }, string>;
+    }, string>;
+    super_admin_cap_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+    admins: import("@mysten/sui/bcs").BcsType<{
+        key: string;
+        value: string[];
+    }[], Iterable<{
+        key: string;
+        value: Iterable<string> & {
+            length: number;
+        };
+    }> & {
+        length: number;
+    }, string>;
+    pending_super_admin: import("@mysten/sui/bcs").BcsType<import("@interest-protocol/blast-core/timelock").Timelocked<string | null | undefined>, import("@interest-protocol/blast-core/timelock").Timelocked<string | null | undefined>, string>;
+}, string>;
+/** A nominated super admin, who may accept from `executeAfterMs`. */
+export type PendingSuperAdmin = {
+    recipient: string;
+    executeAfterMs: bigint;
+};
+export type AclState = SharedObjectIdentity & {
+    /** The one live `SuperAdminCap`. */
+    superAdminCapId: string;
+    /** Every live `AdminCap` and the role types it holds. */
+    admins: Readonly<Record<string, readonly string[]>>;
+    pendingSuperAdmin: PendingSuperAdmin | null;
+};
+export type AclObject = SharedObjectIdentity & {
+    type: string;
+    content: Uint8Array;
+};
+export declare function decodeAclObject(object: AclObject, adminPackageId: string): AclState;
+export declare function getAcl(client: ClientWithCoreApi, objectId: string, adminPackageId: string): Promise<AclState>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAG9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,mDAAmD;AACnD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;UAUjB,CAAC;AAEH,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,MAAM,MAAM,QAAQ,GAAG,oBAAoB,GAAG;IAC5C,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACpD,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,GACrB,QAAQ,CAiCV;AAED,wBAAsB,MAAM,CAC1B,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,CAAC,CAiBnB"}

package/dist/state.js

@@ -0,0 +1,57 @@
+import { addressBcs, moveTypeNameBcs, suiObjectIdBcs, suiUidBcs, } from "@interest-protocol/blast-core/bcs";
+import { normalizePositiveU64 } from "@interest-protocol/blast-core/integers";
+import { timelockedBcs } from "@interest-protocol/blast-core/timelock";
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeSuiObjectId, parseStructTag } from "@mysten/sui/utils";
+/** BCS layout of `blast_admin::blast_acl::ACL`. */
+export const aclBcs = bcs.struct("ACL", {
+    id: suiUidBcs,
+    super_admin_cap_id: suiObjectIdBcs,
+    admins: bcs.vector(bcs.struct("Entry", {
+        key: suiObjectIdBcs,
+        value: bcs.vector(moveTypeNameBcs),
+    })),
+    pending_super_admin: timelockedBcs(bcs.option(addressBcs)),
+});
+export function decodeAclObject(object, adminPackageId) {
+    const tag = parseStructTag(object.type);
+    if (tag.address !== normalizeSuiObjectId(adminPackageId) ||
+        tag.module !== "blast_acl" ||
+        tag.name !== "ACL") {
+        throw new TypeError(`object ${object.objectId} is not the Blast ACL`);
+    }
+    const parsed = aclBcs.parse(object.content);
+    const objectId = normalizeSuiObjectId(object.objectId);
+    if (normalizeSuiObjectId(parsed.id.id.bytes) !== objectId) {
+        throw new TypeError(`ACL ${object.objectId} has a mismatched UID`);
+    }
+    const nominee = parsed.pending_super_admin.after;
+    return {
+        objectId,
+        initialSharedVersion: normalizePositiveU64("initialSharedVersion", object.initialSharedVersion),
+        superAdminCapId: parsed.super_admin_cap_id,
+        admins: Object.fromEntries(parsed.admins.map(({ key, value }) => [key, value])),
+        pendingSuperAdmin: nominee == null
+            ? null
+            : {
+                recipient: nominee,
+                executeAfterMs: parsed.pending_super_admin.atMs,
+            },
+    };
+}
+export async function getAcl(client, objectId, adminPackageId) {
+    const { object } = await client.core.getObject({
+        objectId,
+        include: { content: true },
+    });
+    if (object.owner.$kind !== "Shared") {
+        throw new TypeError(`ACL ${object.objectId} is not a shared object`);
+    }
+    return decodeAclObject({
+        objectId: object.objectId,
+        initialSharedVersion: object.owner.Shared.initialSharedVersion,
+        type: object.type,
+        content: object.content,
+    }, adminPackageId);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEzE,mDAAmD;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE;IACtC,EAAE,EAAE,SAAS;IACb,kBAAkB,EAAE,cAAc;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAChB,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE;QAClB,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC;KACnC,CAAC,CACH;IACD,mBAAmB,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;CAC3D,CAAC,CAAC;AAkBH,MAAM,UAAU,eAAe,CAC7B,MAAiB,EACjB,cAAsB;IAEtB,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IACE,GAAG,CAAC,OAAO,KAAK,oBAAoB,CAAC,cAAc,CAAC;QACpD,GAAG,CAAC,MAAM,KAAK,WAAW;QAC1B,GAAG,CAAC,IAAI,KAAK,KAAK,EAClB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,CAAC,QAAQ,uBAAuB,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,OAAO,MAAM,CAAC,QAAQ,uBAAuB,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC;IACjD,OAAO;QACL,QAAQ;QACR,oBAAoB,EAAE,oBAAoB,CACxC,sBAAsB,EACtB,MAAM,CAAC,oBAAoB,CAC5B;QACD,eAAe,EAAE,MAAM,CAAC,kBAAkB;QAC1C,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CACpD;QACD,iBAAiB,EACf,OAAO,IAAI,IAAI;YACb,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,SAAS,EAAE,OAAO;gBAClB,cAAc,EAAE,MAAM,CAAC,mBAAmB,CAAC,IAAI;aAChD;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAyB,EACzB,QAAgB,EAChB,cAAsB;IAEtB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7C,QAAQ;QACR,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAC3B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CAAC,OAAO,MAAM,CAAC,QAAQ,yBAAyB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,eAAe,CACpB;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB;QAC9D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,EACD,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/transactions.d.ts

@@ -0,0 +1,105 @@
+import type { SharedObjectIdentity } from "@interest-protocol/blast-core/sui";
+import type { TransactionObjectArgument, TransactionObjectInput } from "@mysten/sui/transactions";
+import { Transaction } from "@mysten/sui/transactions";
+/** The immutable `blast_admin` package and its shared singleton `blast_acl::ACL`. */
+export type AdminDeployment = {
+    packageId: string;
+    acl: SharedObjectIdentity;
+};
+export declare function normalizeAdminDeployment(deployment: AdminDeployment): AdminDeployment;
+/**
+ * `blast_admin::blast_acl` calls. A role is a Move type its consumer package
+ * declares (for example `<launchpad>::blast_fun_domain::FeeAdmin`); each
+ * product's `roleType` names its own.
+ */
+export declare class AdminCalls {
+    #private;
+    readonly deployment: AdminDeployment;
+    constructor(deployment: AdminDeployment);
+    /** `sign_in<Role>`: this PTB's `AdminWitness<Role>`; the `AdminCap` must hold `role`. */
+    signIn(options: {
+        adminCap: TransactionObjectInput;
+        role: string;
+    }): (tx: Transaction) => TransactionObjectArgument;
+    /** `grant_admin`: delivers a new `AdminCap` with no role to `recipient`. */
+    grantAdmin(options: {
+        superAdminCap: TransactionObjectInput;
+        recipient: string;
+    }): (tx: Transaction) => void;
+    /** `revoke_admin`: retires a live `AdminCap` and every role it holds. */
+    revokeAdmin(options: {
+        superAdminCap: TransactionObjectInput;
+        adminCapId: string;
+    }): (tx: Transaction) => void;
+    /** `grant_role<Role>` to a live administrator. */
+    grantRole(options: {
+        superAdminCap: TransactionObjectInput;
+        adminCapId: string;
+        role: string;
+    }): (tx: Transaction) => void;
+    /** `revoke_role<Role>` from a live administrator. */
+    revokeRole(options: {
+        superAdminCap: TransactionObjectInput;
+        adminCapId: string;
+        role: string;
+    }): (tx: Transaction) => void;
+    /** `destroy_admin_cap`: deletes the holder's own live or revoked cap. */
+    destroyAdminCap(options: {
+        adminCap: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+    /**
+     * `begin_super_admin_transfer`: nominates `recipient`, who may accept once
+     * the ACL's seven-day delay passes; it replaces a pending nomination.
+     */
+    beginSuperAdminTransfer(options: {
+        superAdminCap: TransactionObjectInput;
+        recipient: string;
+    }): (tx: Transaction) => void;
+    cancelSuperAdminTransfer(options: {
+        superAdminCap: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+    /** `accept_super_admin_transfer`: the sender must be the ready nominee. */
+    acceptSuperAdminTransfer(): (tx: Transaction) => void;
+    /** `destroy_retired_super_admin_cap`: deletes a root an accepted transfer replaced. */
+    destroyRetiredSuperAdminCap(options: {
+        superAdminCap: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+}
+/** One-call PTBs for the ACL's root and administrators. */
+export declare class AdminTransactions {
+    readonly call: AdminCalls;
+    constructor(deployment: AdminDeployment);
+    grantAdmin(options: {
+        superAdminCapId: string;
+        recipient: string;
+    }): Transaction;
+    revokeAdmin(options: {
+        superAdminCapId: string;
+        adminCapId: string;
+    }): Transaction;
+    grantRole(options: {
+        superAdminCapId: string;
+        adminCapId: string;
+        role: string;
+    }): Transaction;
+    revokeRole(options: {
+        superAdminCapId: string;
+        adminCapId: string;
+        role: string;
+    }): Transaction;
+    destroyAdminCap(options: {
+        adminCapId: string;
+    }): Transaction;
+    beginSuperAdminTransfer(options: {
+        superAdminCapId: string;
+        recipient: string;
+    }): Transaction;
+    cancelSuperAdminTransfer(options: {
+        superAdminCapId: string;
+    }): Transaction;
+    acceptSuperAdminTransfer(): Transaction;
+    destroyRetiredSuperAdminCap(options: {
+        superAdminCapId: string;
+    }): Transaction;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

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