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

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @interest-protocol/blast-partners-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 partners package in the [Blast SDK monorepo](https://github.com/interest-protocol/blast-v2-sdk).
+
+```sh
+npm install @interest-protocol/blast-partners-sdk
+```
+
+See the repository README and docs for usage, development, and release guidance.

package/dist/events.d.ts

@@ -0,0 +1,36 @@
+import type { SuiEventPosition } from "@interest-protocol/blast-core/events";
+import type { SuiClientTypes } from "@mysten/sui/client";
+/** The `blast_partners` events, in Move field order. */
+export declare const partnerEventBcs: {
+    /** After every change, registration included: the partner's complete terms. */
+    PartnerUpdated: import("@mysten/sui/bcs").BcsStruct<{
+        recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+        share_bps: import("@mysten/sui/bcs").BcsType<import("@interest-protocol/blast-core/timelock").Timelocked<bigint>, import("@interest-protocol/blast-core/timelock").Timelocked<bigint>, string>;
+        cap_id: import("@mysten/sui/bcs").BcsType<import("@interest-protocol/blast-core/timelock").Timelocked<string>, import("@interest-protocol/blast-core/timelock").Timelocked<string>, string>;
+        partner_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+    }, string>;
+    /** `amount` of the event's coin type sent to the partner's recipient. */
+    PartnerPaid: import("@mysten/sui/bcs").BcsStruct<{
+        partner_id: import("@mysten/sui/bcs").BcsType<string, string, string>;
+        amount: import("@mysten/sui/bcs").BcsType<bigint, bigint, "u64">;
+    }, string>;
+};
+export type PartnerEventKind = keyof typeof partnerEventBcs;
+export type PartnerEventPayloads = {
+    [Kind in PartnerEventKind]: ReturnType<(typeof partnerEventBcs)[Kind]["parse"]>;
+};
+export type DecodedPartnerEvent = {
+    [Kind in PartnerEventKind]: {
+        source: "partners";
+        kind: Kind;
+        payload: PartnerEventPayloads[Kind];
+        /** `PartnerPaid` only: the paid coin type `T`. */
+        coinType: Kind extends "PartnerPaid" ? string : null;
+        sender: string;
+        position: SuiEventPosition;
+    };
+}[PartnerEventKind];
+/** Decodes one `<partnersPackageId>::blast_partners::<Kind>` event. */
+export declare function decodePartnerEvent(event: SuiClientTypes.EventEntry, partnersPackageId: string): DecodedPartnerEvent;
+export declare function partnerEventId(event: DecodedPartnerEvent): 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":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQzD,wDAAwD;AACxD,eAAO,MAAM,eAAe;IAC1B,+EAA+E;IAC/E,cAAc;;;;;;IAId,yEAAyE;IACzE,WAAW;;;;CAIZ,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG;KAChC,IAAI,IAAI,gBAAgB,GAAG,UAAU,CACpC,CAAC,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CACxC;CACF,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;KAC/B,IAAI,IAAI,gBAAgB,GAAG;QAC1B,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC;QACX,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACpC,kDAAkD;QAClD,QAAQ,EAAE,IAAI,SAAS,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;QACrD,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,gBAAgB,CAAC;KAC5B;CACF,CAAC,gBAAgB,CAAC,CAAC;AAEpB,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,CAAC,UAAU,EAChC,iBAAiB,EAAE,MAAM,GACxB,mBAAmB,CAqBrB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEjE"}

package/dist/events.js

@@ -0,0 +1,43 @@
+import { suiObjectIdBcs, u64Bcs } from "@interest-protocol/blast-core/bcs";
+import { normalizeSuiEventPosition, suiEventId, } from "@interest-protocol/blast-core/events";
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeStructTag, normalizeSuiAddress, parseStructTag, } from "@mysten/sui/utils";
+import { partnerTermsBcs } from "./state.js";
+/** The `blast_partners` events, in Move field order. */
+export const partnerEventBcs = {
+    /** After every change, registration included: the partner's complete terms. */
+    PartnerUpdated: bcs.struct("PartnerUpdated", {
+        partner_id: suiObjectIdBcs,
+        ...partnerTermsBcs,
+    }),
+    /** `amount` of the event's coin type sent to the partner's recipient. */
+    PartnerPaid: bcs.struct("PartnerPaid", {
+        partner_id: suiObjectIdBcs,
+        amount: u64Bcs,
+    }),
+};
+/** Decodes one `<partnersPackageId>::blast_partners::<Kind>` event. */
+export function decodePartnerEvent(event, partnersPackageId) {
+    const tag = parseStructTag(event.eventType);
+    const kind = tag.name;
+    const [coinType = null, ...extra] = tag.typeParams;
+    if (tag.address !== normalizeSuiAddress(partnersPackageId) ||
+        tag.module !== "blast_partners" ||
+        !Object.hasOwn(partnerEventBcs, kind) ||
+        (coinType === null) === (kind === "PartnerPaid") ||
+        extra.length > 0) {
+        throw new TypeError(`unexpected partner event type ${event.eventType}`);
+    }
+    return {
+        source: "partners",
+        kind,
+        payload: partnerEventBcs[kind].parse(event.bcs),
+        coinType: coinType && normalizeStructTag(coinType),
+        sender: normalizeSuiAddress(event.sender),
+        position: normalizeSuiEventPosition(event),
+    };
+}
+export function partnerEventId(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,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EACL,yBAAyB,EACzB,UAAU,GACX,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,+EAA+E;IAC/E,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE;QAC3C,UAAU,EAAE,cAAc;QAC1B,GAAG,eAAe;KACnB,CAAC;IACF,yEAAyE;IACzE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE;QACrC,UAAU,EAAE,cAAc;QAC1B,MAAM,EAAE,MAAM;KACf,CAAC;CACH,CAAC;AAsBF,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAChC,KAAgC,EAChC,iBAAyB;IAEzB,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAwB,CAAC;IAC1C,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACnD,IACE,GAAG,CAAC,OAAO,KAAK,mBAAmB,CAAC,iBAAiB,CAAC;QACtD,GAAG,CAAC,MAAM,KAAK,gBAAgB;QAC/B,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC;QACrC,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;QAChD,KAAK,CAAC,MAAM,GAAG,CAAC,EAChB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,iCAAiC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,IAAI;QACJ,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/C,QAAQ,EAAE,QAAQ,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAClD,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC;QACzC,QAAQ,EAAE,yBAAyB,CAAC,KAAK,CAAC;KACpB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,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,17 @@
+import type { DecodedPartnerEvent, PartnerEventKind } from "./events.ts";
+import type { PartnerTerms } from "./state.ts";
+export type PartnerProjection = PartnerTerms & {
+    partnerId: string;
+    /** Everything sent to the partner, by coin type. */
+    paid: Readonly<Record<string, bigint>>;
+};
+/** Partners rebuilt from their events; terms match `PartnerState` once replayed. */
+export type PartnersEventProjection = {
+    appliedEventIds: Readonly<Record<string, true>>;
+    eventCounts: Readonly<Record<PartnerEventKind, number>>;
+    partners: Readonly<Record<string, PartnerProjection>>;
+};
+export declare function createPartnersEventProjection(): PartnersEventProjection;
+/** Applies one event once; replaying an applied event returns `state` unchanged. */
+export declare function reducePartnerEvent(state: PartnersEventProjection, event: DecodedPartnerEvent): PartnersEventProjection;
+//# 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,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF,wBAAgB,6BAA6B,IAAI,uBAAuB,CAQvE;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,mBAAmB,GACzB,uBAAuB,CAiCzB"}

package/dist/reducer.js

@@ -0,0 +1,52 @@
+import { partnerEventBcs, partnerEventId } from "./events.js";
+export function createPartnersEventProjection() {
+    return {
+        appliedEventIds: {},
+        eventCounts: Object.fromEntries(Object.keys(partnerEventBcs).map((kind) => [kind, 0])),
+        partners: {},
+    };
+}
+/** Applies one event once; replaying an applied event returns `state` unchanged. */
+export function reducePartnerEvent(state, event) {
+    const eventId = partnerEventId(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,
+        },
+    };
+    const partnerId = event.payload.partner_id;
+    const current = state.partners[partnerId];
+    if (event.kind === "PartnerUpdated") {
+        const { recipient, share_bps, cap_id } = event.payload;
+        return withPartner(next, {
+            partnerId,
+            recipient,
+            shareBps: share_bps,
+            capId: cap_id,
+            paid: current?.paid ?? {},
+        });
+    }
+    // A partner is registered, with an update, before it can be paid.
+    if (!current)
+        return next;
+    const coinType = event.coinType;
+    return withPartner(next, {
+        ...current,
+        paid: {
+            ...current.paid,
+            [coinType]: (current.paid[coinType] ?? 0n) + event.payload.amount,
+        },
+    });
+}
+function withPartner(state, partner) {
+    return {
+        ...state,
+        partners: { ...state.partners, [partner.partnerId]: partner },
+    };
+}
+//# 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,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgB9D,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,eAAe,EAAE,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAClB;QACrC,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAChC,KAA8B,EAC9B,KAA0B;IAE1B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,IAAI,GAA4B;QACpC,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,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACpC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QACvD,OAAO,WAAW,CAAC,IAAI,EAAE;YACvB,SAAS;YACT,SAAS;YACT,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,kEAAkE;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,OAAO,WAAW,CAAC,IAAI,EAAE;QACvB,GAAG,OAAO;QACV,IAAI,EAAE;YACJ,GAAG,OAAO,CAAC,IAAI;YACf,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM;SAClE;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAClB,KAA8B,EAC9B,OAA0B;IAE1B,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;KAC9D,CAAC;AACJ,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,43 @@
+import type { SharedObjectIdentity } from "@interest-protocol/blast-core/sui";
+import type { Timelocked } from "@interest-protocol/blast-core/timelock";
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+/** `blast_partners::delay_ms`: every change Blast makes to a partner waits this long. */
+export declare const PARTNER_DELAY_MS = 604800000n;
+/** The partner's recipient, scheduled share, and managing cap, as Move stores them. */
+export type PartnerTerms = {
+    recipient: string;
+    /** Basis points of Blast's fee on each trade naming the partner. */
+    shareBps: Timelocked<bigint>;
+    /** The only `PartnerCap` that may set `recipient`. */
+    capId: Timelocked<string>;
+};
+export declare const partnerTermsBcs: {
+    recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+    share_bps: import("@mysten/sui/bcs").BcsType<Timelocked<bigint>, Timelocked<bigint>, string>;
+    cap_id: import("@mysten/sui/bcs").BcsType<Timelocked<string>, Timelocked<string>, string>;
+};
+/** BCS layout of `blast_partners::blast_partners::Partner`. */
+export declare const partnerBcs: import("@mysten/sui/bcs").BcsStruct<{
+    recipient: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+    share_bps: import("@mysten/sui/bcs").BcsType<Timelocked<bigint>, Timelocked<bigint>, string>;
+    cap_id: import("@mysten/sui/bcs").BcsType<Timelocked<string>, Timelocked<string>, string>;
+    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>;
+}, string>;
+export type PartnerState = SharedObjectIdentity & PartnerTerms;
+export type PartnerObject = SharedObjectIdentity & {
+    type: string;
+    content: Uint8Array;
+};
+export declare function decodePartnerObject(object: PartnerObject, partnersPackageId: string): PartnerState;
+export declare function getPartner(client: ClientWithCoreApi, objectId: string, partnersPackageId: string): Promise<PartnerState>;
+/**
+ * Mirrors `blast_partners::pay`: the partner's share of `fee` (Blast's fee on
+ * one trade, in that coin's atoms) at `nowMs`, rounded down; Blast keeps the
+ * remainder.
+ */
+export declare function partnerPayment(partner: Pick<PartnerTerms, "shareBps">, fee: bigint, nowMs: bigint): bigint;
+//# 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":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAMzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,aAAe,CAAC;AAE7C,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7B,sDAAsD;IACtD,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,eAAe;IAC1B,SAAS;IACT,SAAS;IACT,MAAM;CACP,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,UAAU;;;;;;;;;UAGrB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,iBAAiB,EAAE,MAAM,GACxB,YAAY,CAwBd;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}

package/dist/state.js

@@ -0,0 +1,61 @@
+import { addressBcs, suiObjectIdBcs, suiUidBcs, u64Bcs, } from "@interest-protocol/blast-core/bcs";
+import { BASIS_POINTS_DENOMINATOR, mulDivDown, normalizePositiveU64, } from "@interest-protocol/blast-core/integers";
+import { timelockedBcs, timelockedValue, } from "@interest-protocol/blast-core/timelock";
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeSuiObjectId, parseStructTag } from "@mysten/sui/utils";
+/** `blast_partners::delay_ms`: every change Blast makes to a partner waits this long. */
+export const PARTNER_DELAY_MS = 604800000n;
+export const partnerTermsBcs = {
+    recipient: addressBcs,
+    share_bps: timelockedBcs(u64Bcs),
+    cap_id: timelockedBcs(suiObjectIdBcs),
+};
+/** BCS layout of `blast_partners::blast_partners::Partner`. */
+export const partnerBcs = bcs.struct("Partner", {
+    id: suiUidBcs,
+    ...partnerTermsBcs,
+});
+export function decodePartnerObject(object, partnersPackageId) {
+    const tag = parseStructTag(object.type);
+    if (tag.address !== normalizeSuiObjectId(partnersPackageId) ||
+        tag.module !== "blast_partners" ||
+        tag.name !== "Partner") {
+        throw new TypeError(`object ${object.objectId} is not a Blast partner`);
+    }
+    const parsed = partnerBcs.parse(object.content);
+    const objectId = normalizeSuiObjectId(object.objectId);
+    if (normalizeSuiObjectId(parsed.id.id.bytes) !== objectId) {
+        throw new TypeError(`partner ${object.objectId} has a mismatched UID`);
+    }
+    return {
+        objectId,
+        initialSharedVersion: normalizePositiveU64("initialSharedVersion", object.initialSharedVersion),
+        recipient: parsed.recipient,
+        shareBps: parsed.share_bps,
+        capId: parsed.cap_id,
+    };
+}
+export async function getPartner(client, objectId, partnersPackageId) {
+    const { object } = await client.core.getObject({
+        objectId,
+        include: { content: true },
+    });
+    if (object.owner.$kind !== "Shared") {
+        throw new TypeError(`partner ${object.objectId} is not a shared object`);
+    }
+    return decodePartnerObject({
+        objectId: object.objectId,
+        initialSharedVersion: object.owner.Shared.initialSharedVersion,
+        type: object.type,
+        content: object.content,
+    }, partnersPackageId);
+}
+/**
+ * Mirrors `blast_partners::pay`: the partner's share of `fee` (Blast's fee on
+ * one trade, in that coin's atoms) at `nowMs`, rounded down; Blast keeps the
+ * remainder.
+ */
+export function partnerPayment(partner, fee, nowMs) {
+    return mulDivDown(fee, timelockedValue(partner.shareBps, nowMs), BASIS_POINTS_DENOMINATOR);
+}
+//# 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,cAAc,EACd,SAAS,EACT,MAAM,GACP,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,wBAAwB,EACxB,UAAU,EACV,oBAAoB,GACrB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEzE,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAY,CAAC;AAW7C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC;CACtC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE;IAC9C,EAAE,EAAE,SAAS;IACb,GAAG,eAAe;CACnB,CAAC,CAAC;AASH,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,iBAAyB;IAEzB,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IACE,GAAG,CAAC,OAAO,KAAK,oBAAoB,CAAC,iBAAiB,CAAC;QACvD,GAAG,CAAC,MAAM,KAAK,gBAAgB;QAC/B,GAAG,CAAC,IAAI,KAAK,SAAS,EACtB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,CAAC,QAAQ,yBAAyB,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,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,WAAW,MAAM,CAAC,QAAQ,uBAAuB,CAAC,CAAC;IACzE,CAAC;IACD,OAAO;QACL,QAAQ;QACR,oBAAoB,EAAE,oBAAoB,CACxC,sBAAsB,EACtB,MAAM,CAAC,oBAAoB,CAC5B;QACD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,KAAK,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAyB,EACzB,QAAgB,EAChB,iBAAyB;IAEzB,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,WAAW,MAAM,CAAC,QAAQ,yBAAyB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,mBAAmB,CACxB;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,iBAAiB,CAClB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAuC,EACvC,GAAW,EACX,KAAa;IAEb,OAAO,UAAU,CACf,GAAG,EACH,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,EACxC,wBAAwB,CACzB,CAAC;AACJ,CAAC"}

package/dist/transactions.d.ts

@@ -0,0 +1,90 @@
+import type { AdminDeployment } from "@interest-protocol/blast-admin-sdk/transactions";
+import { AdminCalls } from "@interest-protocol/blast-admin-sdk/transactions";
+import type { SharedObjectReference } from "@interest-protocol/blast-core/sui";
+import type { TransactionObjectArgument, TransactionObjectInput, TransactionResult } from "@mysten/sui/transactions";
+import { Transaction } from "@mysten/sui/transactions";
+/** The immutable `blast_partners` package and the ACL its `PartnerAdmin` signs in to. */
+export type PartnersDeployment = {
+    packageId: string;
+    admin: AdminDeployment;
+};
+/** `blast_partners::blast_partners` calls. */
+export declare class PartnersCalls {
+    #private;
+    readonly deployment: PartnersDeployment;
+    readonly admin: AdminCalls;
+    constructor(deployment: PartnersDeployment);
+    /** The `PartnerAdmin` role type, for `AdminCalls.grantRole`. */
+    roleType(): string;
+    /** This PTB's `AdminWitness<PartnerAdmin>`. */
+    signIn(options: {
+        adminCap: TransactionObjectInput;
+    }): (tx: Transaction) => TransactionObjectArgument;
+    /** `new_cap`: anyone may mint one; it controls nothing until a partner names it. */
+    newCap(): (tx: Transaction) => TransactionResult;
+    /**
+     * `register` (`PartnerAdmin`): shares a partner managed by the cap
+     * `capId`, its share and cap in force at once.
+     */
+    register(options: {
+        adminWitness: TransactionObjectInput;
+        capId: string;
+        recipient: string;
+        shareBps: bigint;
+    }): (tx: Transaction) => void;
+    /** `schedule_share` (`PartnerAdmin`): the share takes effect after the partner delay. */
+    scheduleShare(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+        shareBps: bigint;
+    }): (tx: Transaction) => void;
+    /** `schedule_cap` (`PartnerAdmin`): moves the partner to the cap `capId` after the delay. */
+    scheduleCap(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+        capId: string;
+    }): (tx: Transaction) => void;
+    /** `set_recipient`: the partner's live cap sets where it is paid, at once. */
+    setRecipient(options: {
+        partner: SharedObjectReference<true>;
+        partnerCap: TransactionObjectInput;
+        recipient: string;
+    }): (tx: Transaction) => void;
+    destroyCap(options: {
+        partnerCap: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+}
+export declare class PartnersTransactions {
+    #private;
+    readonly call: PartnersCalls;
+    constructor(deployment: PartnersDeployment);
+    /** Mints a `PartnerCap` and sends it to `recipient`. */
+    newCap(options: {
+        recipient: string;
+    }): Transaction;
+    register(options: {
+        adminCapId: string;
+        capId: string;
+        recipient: string;
+        shareBps: bigint;
+    }): Transaction;
+    scheduleShare(options: {
+        adminCapId: string;
+        partner: SharedObjectReference<true>;
+        shareBps: bigint;
+    }): Transaction;
+    scheduleCap(options: {
+        adminCapId: string;
+        partner: SharedObjectReference<true>;
+        capId: string;
+    }): Transaction;
+    setRecipient(options: {
+        partner: SharedObjectReference<true>;
+        partnerCapId: string;
+        recipient: string;
+    }): Transaction;
+    destroyCap(options: {
+        partnerCapId: 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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"}

package/dist/transactions.js

@@ -0,0 +1,150 @@
+import { AdminCalls, normalizeAdminDeployment, } from "@interest-protocol/blast-admin-sdk/transactions";
+import { requireBasisPoints } from "@interest-protocol/blast-core/integers";
+import { normalizeSharedObjectReference } from "@interest-protocol/blast-core/sui";
+import { Transaction } from "@mysten/sui/transactions";
+import { normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
+/** `blast_partners::blast_partners` calls. */
+export class PartnersCalls {
+    deployment;
+    admin;
+    constructor(deployment) {
+        this.deployment = {
+            packageId: normalizeSuiObjectId(deployment.packageId),
+            admin: normalizeAdminDeployment(deployment.admin),
+        };
+        this.admin = new AdminCalls(this.deployment.admin);
+    }
+    /** The `PartnerAdmin` role type, for `AdminCalls.grantRole`. */
+    roleType() {
+        return `${this.deployment.packageId}::blast_partners::PartnerAdmin`;
+    }
+    /** This PTB's `AdminWitness<PartnerAdmin>`. */
+    signIn(options) {
+        return this.admin.signIn({
+            adminCap: options.adminCap,
+            role: this.roleType(),
+        });
+    }
+    /** `new_cap`: anyone may mint one; it controls nothing until a partner names it. */
+    newCap() {
+        return (tx) => tx.moveCall({ target: this.#target("new_cap") });
+    }
+    /**
+     * `register` (`PartnerAdmin`): shares a partner managed by the cap
+     * `capId`, its share and cap in force at once.
+     */
+    register(options) {
+        const capId = normalizeSuiObjectId(options.capId);
+        const recipient = normalizeSuiAddress(options.recipient);
+        const shareBps = requireBasisPoints("shareBps", options.shareBps);
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("register"),
+                arguments: [
+                    tx.object(options.adminWitness),
+                    tx.pure.id(capId),
+                    tx.pure.address(recipient),
+                    tx.pure.u64(shareBps),
+                ],
+            });
+        };
+    }
+    /** `schedule_share` (`PartnerAdmin`): the share takes effect after the partner delay. */
+    scheduleShare(options) {
+        const shareBps = requireBasisPoints("shareBps", options.shareBps);
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("schedule_share"),
+                arguments: [
+                    partner(tx, options.partner),
+                    tx.object(options.adminWitness),
+                    tx.pure.u64(shareBps),
+                    tx.object.clock(),
+                ],
+            });
+        };
+    }
+    /** `schedule_cap` (`PartnerAdmin`): moves the partner to the cap `capId` after the delay. */
+    scheduleCap(options) {
+        const capId = normalizeSuiObjectId(options.capId);
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("schedule_cap"),
+                arguments: [
+                    partner(tx, options.partner),
+                    tx.object(options.adminWitness),
+                    tx.pure.id(capId),
+                    tx.object.clock(),
+                ],
+            });
+        };
+    }
+    /** `set_recipient`: the partner's live cap sets where it is paid, at once. */
+    setRecipient(options) {
+        const recipient = normalizeSuiAddress(options.recipient);
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("set_recipient"),
+                arguments: [
+                    partner(tx, options.partner),
+                    tx.object(options.partnerCap),
+                    tx.pure.address(recipient),
+                    tx.object.clock(),
+                ],
+            });
+        };
+    }
+    destroyCap(options) {
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("destroy_cap"),
+                arguments: [tx.object(options.partnerCap)],
+            });
+        };
+    }
+    #target(functionName) {
+        return `${this.deployment.packageId}::blast_partners::${functionName}`;
+    }
+}
+export class PartnersTransactions {
+    call;
+    constructor(deployment) {
+        this.call = new PartnersCalls(deployment);
+    }
+    /** Mints a `PartnerCap` and sends it to `recipient`. */
+    newCap(options) {
+        const tx = new Transaction();
+        const cap = tx.add(this.call.newCap());
+        tx.transferObjects([cap], normalizeSuiAddress(options.recipient));
+        return tx;
+    }
+    register(options) {
+        return this.#asPartnerAdmin(options.adminCapId, (adminWitness) => this.call.register({ ...options, adminWitness }));
+    }
+    scheduleShare(options) {
+        return this.#asPartnerAdmin(options.adminCapId, (adminWitness) => this.call.scheduleShare({ ...options, adminWitness }));
+    }
+    scheduleCap(options) {
+        return this.#asPartnerAdmin(options.adminCapId, (adminWitness) => this.call.scheduleCap({ ...options, adminWitness }));
+    }
+    setRecipient(options) {
+        const tx = new Transaction();
+        tx.add(this.call.setRecipient({ ...options, partnerCap: options.partnerCapId }));
+        return tx;
+    }
+    destroyCap(options) {
+        const tx = new Transaction();
+        tx.add(this.call.destroyCap({ partnerCap: options.partnerCapId }));
+        return tx;
+    }
+    #asPartnerAdmin(adminCapId, call) {
+        const tx = new Transaction();
+        const adminWitness = tx.add(this.call.signIn({ adminCap: adminCapId }));
+        tx.add(call(adminWitness));
+        return tx;
+    }
+}
+function partner(tx, reference) {
+    return tx.sharedObjectRef(normalizeSharedObjectReference("partner", reference, true));
+}
+//# sourceMappingURL=transactions.js.map

package/dist/transactions.js.map

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

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@interest-protocol/blast-partners-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Blast partners SDK",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/interest-protocol/blast-v2-sdk.git",
+    "directory": "packages/partners"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "default": "./dist/events.js"
+    },
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./reducer": {
+      "types": "./dist/reducer.d.ts",
+      "default": "./dist/reducer.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "default": "./dist/state.js"
+    },
+    "./transactions": {
+      "types": "./dist/transactions.d.ts",
+      "default": "./dist/transactions.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "node --eval \"fs.rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:package": "publint --strict && attw --pack . --profile esm-only",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@interest-protocol/blast-admin-sdk": "0.1.0",
+    "@interest-protocol/blast-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@mysten/sui": "^2.26.2"
+  }
+}

package/src/events.ts

@@ -0,0 +1,79 @@
+import { suiObjectIdBcs, u64Bcs } from "@interest-protocol/blast-core/bcs";
+import type { SuiEventPosition } from "@interest-protocol/blast-core/events";
+import {
+  normalizeSuiEventPosition,
+  suiEventId,
+} from "@interest-protocol/blast-core/events";
+import { bcs } from "@mysten/sui/bcs";
+import type { SuiClientTypes } from "@mysten/sui/client";
+import {
+  normalizeStructTag,
+  normalizeSuiAddress,
+  parseStructTag,
+} from "@mysten/sui/utils";
+import { partnerTermsBcs } from "./state.ts";
+
+/** The `blast_partners` events, in Move field order. */
+export const partnerEventBcs = {
+  /** After every change, registration included: the partner's complete terms. */
+  PartnerUpdated: bcs.struct("PartnerUpdated", {
+    partner_id: suiObjectIdBcs,
+    ...partnerTermsBcs,
+  }),
+  /** `amount` of the event's coin type sent to the partner's recipient. */
+  PartnerPaid: bcs.struct("PartnerPaid", {
+    partner_id: suiObjectIdBcs,
+    amount: u64Bcs,
+  }),
+};
+
+export type PartnerEventKind = keyof typeof partnerEventBcs;
+
+export type PartnerEventPayloads = {
+  [Kind in PartnerEventKind]: ReturnType<
+    (typeof partnerEventBcs)[Kind]["parse"]
+  >;
+};
+
+export type DecodedPartnerEvent = {
+  [Kind in PartnerEventKind]: {
+    source: "partners";
+    kind: Kind;
+    payload: PartnerEventPayloads[Kind];
+    /** `PartnerPaid` only: the paid coin type `T`. */
+    coinType: Kind extends "PartnerPaid" ? string : null;
+    sender: string;
+    position: SuiEventPosition;
+  };
+}[PartnerEventKind];
+
+/** Decodes one `<partnersPackageId>::blast_partners::<Kind>` event. */
+export function decodePartnerEvent(
+  event: SuiClientTypes.EventEntry,
+  partnersPackageId: string,
+): DecodedPartnerEvent {
+  const tag = parseStructTag(event.eventType);
+  const kind = tag.name as PartnerEventKind;
+  const [coinType = null, ...extra] = tag.typeParams;
+  if (
+    tag.address !== normalizeSuiAddress(partnersPackageId) ||
+    tag.module !== "blast_partners" ||
+    !Object.hasOwn(partnerEventBcs, kind) ||
+    (coinType === null) === (kind === "PartnerPaid") ||
+    extra.length > 0
+  ) {
+    throw new TypeError(`unexpected partner event type ${event.eventType}`);
+  }
+  return {
+    source: "partners",
+    kind,
+    payload: partnerEventBcs[kind].parse(event.bcs),
+    coinType: coinType && normalizeStructTag(coinType),
+    sender: normalizeSuiAddress(event.sender),
+    position: normalizeSuiEventPosition(event),
+  } as DecodedPartnerEvent;
+}
+
+export function partnerEventId(event: DecodedPartnerEvent): string {
+  return suiEventId(event.position);
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./events.ts";
+export * from "./reducer.ts";
+export * from "./state.ts";
+export * from "./transactions.ts";

package/src/reducer.ts

@@ -0,0 +1,75 @@
+import type { DecodedPartnerEvent, PartnerEventKind } from "./events.ts";
+import { partnerEventBcs, partnerEventId } from "./events.ts";
+import type { PartnerTerms } from "./state.ts";
+
+export type PartnerProjection = PartnerTerms & {
+  partnerId: string;
+  /** Everything sent to the partner, by coin type. */
+  paid: Readonly<Record<string, bigint>>;
+};
+
+/** Partners rebuilt from their events; terms match `PartnerState` once replayed. */
+export type PartnersEventProjection = {
+  appliedEventIds: Readonly<Record<string, true>>;
+  eventCounts: Readonly<Record<PartnerEventKind, number>>;
+  partners: Readonly<Record<string, PartnerProjection>>;
+};
+
+export function createPartnersEventProjection(): PartnersEventProjection {
+  return {
+    appliedEventIds: {},
+    eventCounts: Object.fromEntries(
+      Object.keys(partnerEventBcs).map((kind) => [kind, 0]),
+    ) as Record<PartnerEventKind, number>,
+    partners: {},
+  };
+}
+
+/** Applies one event once; replaying an applied event returns `state` unchanged. */
+export function reducePartnerEvent(
+  state: PartnersEventProjection,
+  event: DecodedPartnerEvent,
+): PartnersEventProjection {
+  const eventId = partnerEventId(event);
+  if (state.appliedEventIds[eventId]) return state;
+  const next: PartnersEventProjection = {
+    ...state,
+    appliedEventIds: { ...state.appliedEventIds, [eventId]: true },
+    eventCounts: {
+      ...state.eventCounts,
+      [event.kind]: state.eventCounts[event.kind] + 1,
+    },
+  };
+  const partnerId = event.payload.partner_id;
+  const current = state.partners[partnerId];
+  if (event.kind === "PartnerUpdated") {
+    const { recipient, share_bps, cap_id } = event.payload;
+    return withPartner(next, {
+      partnerId,
+      recipient,
+      shareBps: share_bps,
+      capId: cap_id,
+      paid: current?.paid ?? {},
+    });
+  }
+  // A partner is registered, with an update, before it can be paid.
+  if (!current) return next;
+  const coinType = event.coinType;
+  return withPartner(next, {
+    ...current,
+    paid: {
+      ...current.paid,
+      [coinType]: (current.paid[coinType] ?? 0n) + event.payload.amount,
+    },
+  });
+}
+
+function withPartner(
+  state: PartnersEventProjection,
+  partner: PartnerProjection,
+): PartnersEventProjection {
+  return {
+    ...state,
+    partners: { ...state.partners, [partner.partnerId]: partner },
+  };
+}

package/src/state.ts

@@ -0,0 +1,120 @@
+import {
+  addressBcs,
+  suiObjectIdBcs,
+  suiUidBcs,
+  u64Bcs,
+} from "@interest-protocol/blast-core/bcs";
+import {
+  BASIS_POINTS_DENOMINATOR,
+  mulDivDown,
+  normalizePositiveU64,
+} from "@interest-protocol/blast-core/integers";
+import type { SharedObjectIdentity } from "@interest-protocol/blast-core/sui";
+import type { Timelocked } from "@interest-protocol/blast-core/timelock";
+import {
+  timelockedBcs,
+  timelockedValue,
+} from "@interest-protocol/blast-core/timelock";
+import { bcs } from "@mysten/sui/bcs";
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import { normalizeSuiObjectId, parseStructTag } from "@mysten/sui/utils";
+
+/** `blast_partners::delay_ms`: every change Blast makes to a partner waits this long. */
+export const PARTNER_DELAY_MS = 604_800_000n;
+
+/** The partner's recipient, scheduled share, and managing cap, as Move stores them. */
+export type PartnerTerms = {
+  recipient: string;
+  /** Basis points of Blast's fee on each trade naming the partner. */
+  shareBps: Timelocked<bigint>;
+  /** The only `PartnerCap` that may set `recipient`. */
+  capId: Timelocked<string>;
+};
+
+export const partnerTermsBcs = {
+  recipient: addressBcs,
+  share_bps: timelockedBcs(u64Bcs),
+  cap_id: timelockedBcs(suiObjectIdBcs),
+};
+
+/** BCS layout of `blast_partners::blast_partners::Partner`. */
+export const partnerBcs = bcs.struct("Partner", {
+  id: suiUidBcs,
+  ...partnerTermsBcs,
+});
+
+export type PartnerState = SharedObjectIdentity & PartnerTerms;
+
+export type PartnerObject = SharedObjectIdentity & {
+  type: string;
+  content: Uint8Array;
+};
+
+export function decodePartnerObject(
+  object: PartnerObject,
+  partnersPackageId: string,
+): PartnerState {
+  const tag = parseStructTag(object.type);
+  if (
+    tag.address !== normalizeSuiObjectId(partnersPackageId) ||
+    tag.module !== "blast_partners" ||
+    tag.name !== "Partner"
+  ) {
+    throw new TypeError(`object ${object.objectId} is not a Blast partner`);
+  }
+  const parsed = partnerBcs.parse(object.content);
+  const objectId = normalizeSuiObjectId(object.objectId);
+  if (normalizeSuiObjectId(parsed.id.id.bytes) !== objectId) {
+    throw new TypeError(`partner ${object.objectId} has a mismatched UID`);
+  }
+  return {
+    objectId,
+    initialSharedVersion: normalizePositiveU64(
+      "initialSharedVersion",
+      object.initialSharedVersion,
+    ),
+    recipient: parsed.recipient,
+    shareBps: parsed.share_bps,
+    capId: parsed.cap_id,
+  };
+}
+
+export async function getPartner(
+  client: ClientWithCoreApi,
+  objectId: string,
+  partnersPackageId: string,
+): Promise<PartnerState> {
+  const { object } = await client.core.getObject({
+    objectId,
+    include: { content: true },
+  });
+  if (object.owner.$kind !== "Shared") {
+    throw new TypeError(`partner ${object.objectId} is not a shared object`);
+  }
+  return decodePartnerObject(
+    {
+      objectId: object.objectId,
+      initialSharedVersion: object.owner.Shared.initialSharedVersion,
+      type: object.type,
+      content: object.content,
+    },
+    partnersPackageId,
+  );
+}
+
+/**
+ * Mirrors `blast_partners::pay`: the partner's share of `fee` (Blast's fee on
+ * one trade, in that coin's atoms) at `nowMs`, rounded down; Blast keeps the
+ * remainder.
+ */
+export function partnerPayment(
+  partner: Pick<PartnerTerms, "shareBps">,
+  fee: bigint,
+  nowMs: bigint,
+): bigint {
+  return mulDivDown(
+    fee,
+    timelockedValue(partner.shareBps, nowMs),
+    BASIS_POINTS_DENOMINATOR,
+  );
+}

package/src/transactions.ts

@@ -0,0 +1,239 @@
+import type { AdminDeployment } from "@interest-protocol/blast-admin-sdk/transactions";
+import {
+  AdminCalls,
+  normalizeAdminDeployment,
+} from "@interest-protocol/blast-admin-sdk/transactions";
+import { requireBasisPoints } from "@interest-protocol/blast-core/integers";
+import type { SharedObjectReference } from "@interest-protocol/blast-core/sui";
+import { normalizeSharedObjectReference } from "@interest-protocol/blast-core/sui";
+import type {
+  TransactionObjectArgument,
+  TransactionObjectInput,
+  TransactionResult,
+} from "@mysten/sui/transactions";
+import { Transaction } from "@mysten/sui/transactions";
+import { normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
+
+/** The immutable `blast_partners` package and the ACL its `PartnerAdmin` signs in to. */
+export type PartnersDeployment = {
+  packageId: string;
+  admin: AdminDeployment;
+};
+
+/** `blast_partners::blast_partners` calls. */
+export class PartnersCalls {
+  readonly deployment: PartnersDeployment;
+  readonly admin: AdminCalls;
+
+  constructor(deployment: PartnersDeployment) {
+    this.deployment = {
+      packageId: normalizeSuiObjectId(deployment.packageId),
+      admin: normalizeAdminDeployment(deployment.admin),
+    };
+    this.admin = new AdminCalls(this.deployment.admin);
+  }
+
+  /** The `PartnerAdmin` role type, for `AdminCalls.grantRole`. */
+  roleType(): string {
+    return `${this.deployment.packageId}::blast_partners::PartnerAdmin`;
+  }
+
+  /** This PTB's `AdminWitness<PartnerAdmin>`. */
+  signIn(options: { adminCap: TransactionObjectInput }) {
+    return this.admin.signIn({
+      adminCap: options.adminCap,
+      role: this.roleType(),
+    });
+  }
+
+  /** `new_cap`: anyone may mint one; it controls nothing until a partner names it. */
+  newCap() {
+    return (tx: Transaction): TransactionResult =>
+      tx.moveCall({ target: this.#target("new_cap") });
+  }
+
+  /**
+   * `register` (`PartnerAdmin`): shares a partner managed by the cap
+   * `capId`, its share and cap in force at once.
+   */
+  register(options: {
+    adminWitness: TransactionObjectInput;
+    capId: string;
+    recipient: string;
+    shareBps: bigint;
+  }) {
+    const capId = normalizeSuiObjectId(options.capId);
+    const recipient = normalizeSuiAddress(options.recipient);
+    const shareBps = requireBasisPoints("shareBps", options.shareBps);
+    return (tx: Transaction): void => {
+      tx.moveCall({
+        target: this.#target("register"),
+        arguments: [
+          tx.object(options.adminWitness),
+          tx.pure.id(capId),
+          tx.pure.address(recipient),
+          tx.pure.u64(shareBps),
+        ],
+      });
+    };
+  }
+
+  /** `schedule_share` (`PartnerAdmin`): the share takes effect after the partner delay. */
+  scheduleShare(options: {
+    partner: SharedObjectReference<true>;
+    adminWitness: TransactionObjectInput;
+    shareBps: bigint;
+  }) {
+    const shareBps = requireBasisPoints("shareBps", options.shareBps);
+    return (tx: Transaction): void => {
+      tx.moveCall({
+        target: this.#target("schedule_share"),
+        arguments: [
+          partner(tx, options.partner),
+          tx.object(options.adminWitness),
+          tx.pure.u64(shareBps),
+          tx.object.clock(),
+        ],
+      });
+    };
+  }
+
+  /** `schedule_cap` (`PartnerAdmin`): moves the partner to the cap `capId` after the delay. */
+  scheduleCap(options: {
+    partner: SharedObjectReference<true>;
+    adminWitness: TransactionObjectInput;
+    capId: string;
+  }) {
+    const capId = normalizeSuiObjectId(options.capId);
+    return (tx: Transaction): void => {
+      tx.moveCall({
+        target: this.#target("schedule_cap"),
+        arguments: [
+          partner(tx, options.partner),
+          tx.object(options.adminWitness),
+          tx.pure.id(capId),
+          tx.object.clock(),
+        ],
+      });
+    };
+  }
+
+  /** `set_recipient`: the partner's live cap sets where it is paid, at once. */
+  setRecipient(options: {
+    partner: SharedObjectReference<true>;
+    partnerCap: TransactionObjectInput;
+    recipient: string;
+  }) {
+    const recipient = normalizeSuiAddress(options.recipient);
+    return (tx: Transaction): void => {
+      tx.moveCall({
+        target: this.#target("set_recipient"),
+        arguments: [
+          partner(tx, options.partner),
+          tx.object(options.partnerCap),
+          tx.pure.address(recipient),
+          tx.object.clock(),
+        ],
+      });
+    };
+  }
+
+  destroyCap(options: { partnerCap: TransactionObjectInput }) {
+    return (tx: Transaction): void => {
+      tx.moveCall({
+        target: this.#target("destroy_cap"),
+        arguments: [tx.object(options.partnerCap)],
+      });
+    };
+  }
+
+  #target(functionName: string): string {
+    return `${this.deployment.packageId}::blast_partners::${functionName}`;
+  }
+}
+
+export class PartnersTransactions {
+  readonly call: PartnersCalls;
+
+  constructor(deployment: PartnersDeployment) {
+    this.call = new PartnersCalls(deployment);
+  }
+
+  /** Mints a `PartnerCap` and sends it to `recipient`. */
+  newCap(options: { recipient: string }): Transaction {
+    const tx = new Transaction();
+    const cap = tx.add(this.call.newCap());
+    tx.transferObjects([cap], normalizeSuiAddress(options.recipient));
+    return tx;
+  }
+
+  register(options: {
+    adminCapId: string;
+    capId: string;
+    recipient: string;
+    shareBps: bigint;
+  }): Transaction {
+    return this.#asPartnerAdmin(options.adminCapId, (adminWitness) =>
+      this.call.register({ ...options, adminWitness }),
+    );
+  }
+
+  scheduleShare(options: {
+    adminCapId: string;
+    partner: SharedObjectReference<true>;
+    shareBps: bigint;
+  }): Transaction {
+    return this.#asPartnerAdmin(options.adminCapId, (adminWitness) =>
+      this.call.scheduleShare({ ...options, adminWitness }),
+    );
+  }
+
+  scheduleCap(options: {
+    adminCapId: string;
+    partner: SharedObjectReference<true>;
+    capId: string;
+  }): Transaction {
+    return this.#asPartnerAdmin(options.adminCapId, (adminWitness) =>
+      this.call.scheduleCap({ ...options, adminWitness }),
+    );
+  }
+
+  setRecipient(options: {
+    partner: SharedObjectReference<true>;
+    partnerCapId: string;
+    recipient: string;
+  }): Transaction {
+    const tx = new Transaction();
+    tx.add(
+      this.call.setRecipient({ ...options, partnerCap: options.partnerCapId }),
+    );
+    return tx;
+  }
+
+  destroyCap(options: { partnerCapId: string }): Transaction {
+    const tx = new Transaction();
+    tx.add(this.call.destroyCap({ partnerCap: options.partnerCapId }));
+    return tx;
+  }
+
+  #asPartnerAdmin(
+    adminCapId: string,
+    call: (
+      adminWitness: TransactionObjectArgument,
+    ) => (tx: Transaction) => void,
+  ): Transaction {
+    const tx = new Transaction();
+    const adminWitness = tx.add(this.call.signIn({ adminCap: adminCapId }));
+    tx.add(call(adminWitness));
+    return tx;
+  }
+}
+
+function partner(
+  tx: Transaction,
+  reference: SharedObjectReference<true>,
+): TransactionObjectArgument {
+  return tx.sharedObjectRef(
+    normalizeSharedObjectReference("partner", reference, true),
+  );
+}