@1sat/actions 0.0.49 → 0.0.51

package/dist/funding/index.d.ts

@@ -0,0 +1,25 @@
+import type { AtomicBEEF, CreateActionArgs } from '@bsv/sdk';
+/**
+ * External funding provider for actions where a third party pays
+ * for the transaction instead of the wallet.
+ *
+ * Receives the full CreateActionArgs so it can build the exact transaction
+ * the caller described (inputs, outputs, ordering), adding its own funding.
+ *
+ * Implementations handle funding strategy (free tier, metered, paid plans, etc.)
+ * and return the broadcasted transaction as BEEF for wallet internalization.
+ */
+export interface FundingProvider {
+    /**
+     * Build, fund, and broadcast a transaction from the given action args.
+     *
+     * @param args - Full CreateActionArgs (inputs, outputs, options)
+     * @returns txid and BEEF of the broadcasted transaction
+     */
+    fund(args: CreateActionArgs): Promise<FundingResult>;
+}
+export interface FundingResult {
+    txid: string;
+    tx: AtomicBEEF;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/funding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/funding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE5D;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,UAAU,CAAA;CACd"}

package/dist/funding/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/funding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/funding/index.ts"],"names":[],"mappings":""}

package/dist/identity/index.d.ts

@@ -1,39 +1,44 @@
 /**
  * Identity Module
  *
- * BAP identity actions: attestations and alias/profile updates.
- * Uses the wallet's BAP signing key ([1, "sigma"] / "identity") via applyAip.
+ * BAP identity actions using the wallet's identity-{N} key derivation scheme.
  *
- * Prerequisite: Sigma Identity must seed the wallet's `bap` basket with
- * an output tagged `type:id` and `bapId:<hash>` so actions can resolve
- * the BAP identity key from wallet state.
+ * Key hierarchy:
+ *   identity-0 = root key (BAP ID source, signs initial publish)
+ *   identity-{N} = current signing key (N tracked via seq tags on outputs)
+ *
+ * All keys derived at protocolID=[1,"sigma"], keyID="identity-{N}".
+ */
+import type { Action, ActionOptions, OneSatContext } from '../types';
+/**
+ * Compute the BAP ID deterministically from the wallet's identity-0 key.
+ *
+ * BAP ID = base58(ripemd160(sha256(identity-0.address)))
+ *
+ * This always returns a value — every wallet can derive identity-0.
  */
-import type { Action, OneSatContext } from '../types';
+export declare function computeBapId(ctx: OneSatContext): Promise<string>;
 /**
- * Resolve the BAP identity key from the wallet's `bap` basket.
+ * Resolve the BAP ID if the identity has been published.
  *
- * Looks for an output tagged `type:id` and extracts the `bapId:` tag value.
- * Returns null if no identity output exists (Sigma Identity hasn't seeded
- * the wallet yet).
+ * Returns the BAP ID if a `type:id` output exists in the BAP basket,
+ * null if the identity hasn't been published yet.
  */
 export declare function resolveBapId(ctx: OneSatContext): Promise<string | null>;
-export interface PublishIdentityRequest {
-    /** Pre-signed BAP ID locking script hex (AIP-signed with root key) */
-    signedScript: string;
-}
-export interface AttestRequest {
+export interface AttestRequest extends ActionOptions {
     /** SHA-256 hash of the attestation URN (urn:bap:id:attribute:value:nonce) */
     attestationHash: string;
     /** Attestation sequence number (default "0") */
     counter?: string;
 }
-export interface UpdateProfileRequest {
+export interface UpdateProfileRequest extends ActionOptions {
     /** Schema.org profile data (e.g. { "@type": "Person", "name": "Alice" }) */
     profile: Record<string, unknown>;
 }
 export interface IdentityResponse {
     txid?: string;
     rawtx?: string;
+    bapId?: string;
     error?: string;
 }
 export interface ProfileResponse {
@@ -42,31 +47,36 @@ export interface ProfileResponse {
     error?: string;
 }
 /**
- * Publish a BAP ID record using a pre-signed locking script.
+ * Publish the initial BAP ID record.
  *
- * The caller (Sigma Identity) signs the ID OP_RETURN with the root key
- * via PrivateKeySigner + AIP. This action validates the script, verifies
- * the AIP signature, confirms the currentAddress matches this wallet,
- * then funds the transaction via the BRC-100 wallet. The output lands
- * in the `bap` basket so that resolveBapId() can find it.
+ * Derives identity-0 (root key), computes the BAP ID, and publishes
+ * the ID record signed by identity-0 via AIP. The output lands in
+ * the `bap` basket tagged with seq:1.
  *
- * For Droplit-funded onboarding, use internalizeAction() directly instead.
+ * Returns an error if an identity has already been published.
  */
-export declare const publishIdentity: Action<PublishIdentityRequest, IdentityResponse>;
+export declare const publishIdentity: Action<ActionOptions, IdentityResponse>;
+/**
+ * Rotate the BAP signing key.
+ *
+ * Finds the current signing key (highest sequence), derives the next
+ * key (identity-{N+1}), builds a new BAP ID record declaring the new
+ * currentAddress, signs it with the outgoing key, and publishes.
+ * The previous ID output is relinquished.
+ */
+export declare const rotateIdentity: Action<ActionOptions, IdentityResponse>;
 /**
  * Publish a BAP ATTEST transaction.
  *
  * OP_RETURN: BAP_PREFIX | "ATTEST" | attestation_hash | counter
- * Signed with AIP via the wallet's BAP signing key.
+ * Signed with AIP via the current signing key.
  */
 export declare const attest: Action<AttestRequest, IdentityResponse>;
 /**
  * Publish a BAP ALIAS transaction to update the identity's profile.
  *
  * OP_RETURN: BAP_PREFIX | "ALIAS" | bap_id | profile_json
- * Signed with AIP via the wallet's BAP signing key.
- *
- * The BAP ID is resolved from the wallet's `bap` basket (seeded by Sigma Identity).
+ * Signed with AIP via the current signing key.
  */
 export declare const updateProfile: Action<UpdateProfileRequest, IdentityResponse>;
 /**
@@ -77,5 +87,5 @@ export declare const updateProfile: Action<UpdateProfileRequest, IdentityRespons
  */
 export declare const getProfile: Action<Record<string, never>, ProfileResponse>;
 /** All identity actions for registry */
-export declare const identityActions: (Action<PublishIdentityRequest, IdentityResponse> | Action<AttestRequest, IdentityResponse> | Action<UpdateProfileRequest, IdentityResponse> | Action<Record<string, never>, ProfileResponse>)[];
+export declare const identityActions: (Action<AttestRequest, IdentityResponse> | Action<UpdateProfileRequest, IdentityResponse> | Action<Record<string, never>, ProfileResponse>)[];
 //# sourceMappingURL=index.d.ts.map

package/dist/identity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAUrD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe7E;AAMD,MAAM,WAAW,sBAAsB;IACtC,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAgJD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,sBAAsB,EAAE,gBAAgB,CA6D3E,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAgE1D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAkFxE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,CAyDrE,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,eAAe,kMAAuD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AA6BpE;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,aAAa,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAiCD,MAAM,WAAW,aAAc,SAAQ,aAAa;IACnD,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IAC1D,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAwElE,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAmFlE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAqE1D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CA8ExE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,CAqDrE,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,eAAe,+IAM3B,CAAA"}