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

package/dist/transactions.d.ts

@@ -0,0 +1,129 @@
+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 canonical `blast_partners` package (immutability deferred) 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`): proposes the share, which `applyShare`
+     * applies once `PARTNER_DELAY_MS` has passed. A new proposal replaces a
+     * pending one and restarts the notice.
+     */
+    scheduleShare(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+        shareBps: bigint;
+    }): (tx: Transaction) => void;
+    /**
+     * `schedule_cap` (`PartnerAdmin`): proposes moving the partner to the cap
+     * `capId`, which `applyCap` applies once `PARTNER_DELAY_MS` has passed.
+     */
+    scheduleCap(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+        capId: string;
+    }): (tx: Transaction) => void;
+    /** `apply_share`: anyone applies the proposed share once its notice has passed. */
+    applyShare(options: {
+        partner: SharedObjectReference<true>;
+    }): (tx: Transaction) => void;
+    /** `apply_cap`: anyone applies the proposed managing cap once its notice has passed. */
+    applyCap(options: {
+        partner: SharedObjectReference<true>;
+    }): (tx: Transaction) => void;
+    /** `cancel_share` (`PartnerAdmin`): discards the proposed share, even a ready one. */
+    cancelShare(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+    /** `cancel_cap` (`PartnerAdmin`): discards the proposed managing cap, even a ready one. */
+    cancelCap(options: {
+        partner: SharedObjectReference<true>;
+        adminWitness: TransactionObjectInput;
+    }): (tx: Transaction) => void;
+    /** `set_recipient`: the partner's applied 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;
+    applyShare(options: {
+        partner: SharedObjectReference<true>;
+    }): Transaction;
+    applyCap(options: {
+        partner: SharedObjectReference<true>;
+    }): Transaction;
+    cancelShare(options: {
+        adminCapId: string;
+        partner: SharedObjectReference<true>;
+    }): Transaction;
+    cancelCap(options: {
+        adminCapId: string;
+        partner: SharedObjectReference<true>;
+    }): 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,214 @@
+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`): proposes the share, which `applyShare`
+     * applies once `PARTNER_DELAY_MS` has passed. A new proposal replaces a
+     * pending one and restarts the notice.
+     */
+    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`): proposes moving the partner to the cap
+     * `capId`, which `applyCap` applies once `PARTNER_DELAY_MS` has passed.
+     */
+    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(),
+                ],
+            });
+        };
+    }
+    /** `apply_share`: anyone applies the proposed share once its notice has passed. */
+    applyShare(options) {
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("apply_share"),
+                arguments: [partner(tx, options.partner), tx.object.clock()],
+            });
+        };
+    }
+    /** `apply_cap`: anyone applies the proposed managing cap once its notice has passed. */
+    applyCap(options) {
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("apply_cap"),
+                arguments: [partner(tx, options.partner), tx.object.clock()],
+            });
+        };
+    }
+    /** `cancel_share` (`PartnerAdmin`): discards the proposed share, even a ready one. */
+    cancelShare(options) {
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("cancel_share"),
+                arguments: [
+                    partner(tx, options.partner),
+                    tx.object(options.adminWitness),
+                ],
+            });
+        };
+    }
+    /** `cancel_cap` (`PartnerAdmin`): discards the proposed managing cap, even a ready one. */
+    cancelCap(options) {
+        return (tx) => {
+            tx.moveCall({
+                target: this.#target("cancel_cap"),
+                arguments: [
+                    partner(tx, options.partner),
+                    tx.object(options.adminWitness),
+                ],
+            });
+        };
+    }
+    /** `set_recipient`: the partner's applied 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),
+                ],
+            });
+        };
+    }
+    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 }));
+    }
+    applyShare(options) {
+        const tx = new Transaction();
+        tx.add(this.call.applyShare(options));
+        return tx;
+    }
+    applyCap(options) {
+        const tx = new Transaction();
+        tx.add(this.call.applyCap(options));
+        return tx;
+    }
+    cancelShare(options) {
+        return this.#asPartnerAdmin(options.adminCapId, (adminWitness) => this.call.cancelShare({ ...options, adminWitness }));
+    }
+    cancelCap(options) {
+        return this.#asPartnerAdmin(options.adminCapId, (adminWitness) => this.call.cancelCap({ ...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.2.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.2.0",
+    "@interest-protocol/blast-core": "0.2.0"
+  },
+  "peerDependencies": {
+    "@mysten/sui": "^2.26.2"
+  }
+}

package/src/events.ts

@@ -0,0 +1,160 @@
+import type {
+  DecodedDelayedEvent,
+  DelayedKeySpecs,
+} from "@interest-protocol/blast-admin-sdk/events";
+import { decodeDelayedEvent } from "@interest-protocol/blast-admin-sdk/events";
+import {
+  addressBcs,
+  suiObjectIdBcs,
+  u64Bcs,
+  unitKeyBcs,
+} 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";
+
+/** The `blast_partners` events, in Move field order. */
+export const partnerEventBcs = {
+  /**
+   * At registration and on every recipient change: the partner's recipient.
+   * Share and cap terms are `blast_admin::delayed` events (`partnerDelayedKeys`).
+   */
+  PartnerUpdated: bcs.struct("PartnerUpdated", {
+    partner_id: suiObjectIdBcs,
+    recipient: addressBcs,
+  }),
+  /** `amount` of the event's coin type sent to the partner's recipient. */
+  PartnerPaid: bcs.struct("PartnerPaid", {
+    partner_id: suiObjectIdBcs,
+    amount: u64Bcs,
+  }),
+  /**
+   * `partner_list::add`: the list owned by `parent` (a product configuration's
+   * ID) accepts `partner_id` without end.
+   */
+  PartnerAdded: bcs.struct("PartnerAdded", {
+    parent: suiObjectIdBcs,
+    partner_id: suiObjectIdBcs,
+  }),
+  /** `partner_list::remove`: new sales stop naming the partner from `acceptance_ends_at_ms`. */
+  PartnerRemoved: bcs.struct("PartnerRemoved", {
+    parent: suiObjectIdBcs,
+    partner_id: suiObjectIdBcs,
+    acceptance_ends_at_ms: u64Bcs,
+  }),
+  /** `partner_list::destroy`: the list owned by `parent` and its entries are gone. */
+  PartnerListDestroyed: bcs.struct("PartnerListDestroyed", {
+    parent: suiObjectIdBcs,
+  }),
+};
+
+export type PartnerEventKind = keyof typeof partnerEventBcs;
+
+/** The module each event is defined in. */
+const PARTNER_EVENT_MODULES: Record<PartnerEventKind, string> = {
+  PartnerUpdated: "blast_partners",
+  PartnerPaid: "blast_partners",
+  PartnerAdded: "partner_list",
+  PartnerRemoved: "partner_list",
+  PartnerListDestroyed: "partner_list",
+};
+
+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>` or
+ * `<partnersPackageId>::partner_list::<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) ||
+    !Object.hasOwn(partnerEventBcs, kind) ||
+    tag.module !== PARTNER_EVENT_MODULES[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: { position: SuiEventPosition }): string {
+  return suiEventId(event.position);
+}
+
+/**
+ * `blast_partners` keys of `blast_admin::delayed` settings, each owned by the
+ * partner: its share in basis points and its managing cap's ID. Registration
+ * emits `DelayedCreated` for both; a proposal changes nothing until
+ * `DelayedApplied`.
+ */
+export const partnerDelayedKeys = {
+  Share: {
+    key: "blast_partners::ShareKey",
+    family: "setting",
+    keyBcs: unitKeyBcs,
+    valueBcs: u64Bcs,
+    valueType: "u64",
+  },
+  Cap: {
+    key: "blast_partners::CapKey",
+    family: "setting",
+    keyBcs: unitKeyBcs,
+    valueBcs: suiObjectIdBcs,
+    valueType: "0x2::object::ID",
+  },
+} as const satisfies DelayedKeySpecs;
+
+export type DecodedPartnerDelayedEvent = DecodedDelayedEvent<
+  typeof partnerDelayedKeys
+>;
+
+/** Decodes a `<adminPackageId>::delayed` event keyed by `blast_partners`. */
+export function decodePartnerDelayedEvent(
+  event: SuiClientTypes.EventEntry,
+  packages: { adminPackageId: string; partnersPackageId: string },
+): DecodedPartnerDelayedEvent {
+  return decodeDelayedEvent(event, {
+    adminPackageId: packages.adminPackageId,
+    packageId: packages.partnersPackageId,
+    keys: partnerDelayedKeys,
+  });
+}

package/src/index.ts

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