@continuumdao/continuum-node-sdk 1.2.14 → 1.2.16

package/dist/detops/management-signer.d.ts

@@ -0,0 +1,129 @@
+import type { NodeSdkConfig } from '../config/schema.js';
+import { MPA_HOME_DIR, MANAGEMENT_KEYS_DIR } from '../config/paths.js';
+import type { SdkEmptyResult, SdkResult } from './result.js';
+import { type ManagementKeyEntry, type ManagementKeyResult, type SignedManagementBody } from './schemas.js';
+import type { ManagementKeyOption, ManagementSigningMethod, EIP191ManagementSigning, SelectedSigningKey } from '../schemas/extended.js';
+export type { ManagementKeyEntry, ManagementKeyResult, SignedManagementBody } from './schemas.js';
+export type { ManagementKeyOption, ManagementSigningMethod, Ed25519ManagementSigning, EIP191ManagementSigning, } from '../schemas/extended.js';
+export { DEFAULT_MANAGEMENT_SIGNING } from '../schemas/extended.js';
+export type ManagementKeysResult = {
+    readonly managementKeys: ManagementKeyEntry[];
+    readonly signingOptions: ManagementKeyOption[];
+};
+type LocalManagementKeyEntry = {
+    fileName: string;
+    publicKeyRaw: string;
+    publicKeyHex?: string;
+};
+type ToMcpApiError = (message: string, data?: unknown) => Error;
+export type SignedManagementRequest = {
+    selectedSigningKey?: ManagementKeyOption;
+    body: Record<string, unknown>;
+    canonicalJson: string;
+    signingMessage: string;
+    signature: string;
+};
+export type PrepareSignedContext = {
+    nodeKey: string;
+    selectedSigningKey?: ManagementKeyOption;
+};
+export type ManagementSigningContext = {
+    nonce: number;
+    nodeKey: string;
+    publicKey?: string;
+};
+export type ManagementSignEd25519Options = {
+    publicKey?: string;
+    nonce?: number;
+    keyPath?: string;
+};
+export type ManagementSignResult = {
+    body: SignedManagementBody;
+    canonicalJson: string;
+};
+export declare function normalizeEd25519PublicKeyToHex(value: string, toMcpApiError?: ToMcpApiError): string;
+export declare function buildManagementSigningMessage(bodyWithEmptySig: Record<string, unknown>): string;
+export declare function listLocalManagementPublicKeys(keyRoot: string, toMcpApiError?: ToMcpApiError): Promise<LocalManagementKeyEntry[]>;
+export declare function ensureLocalKeyPairForPublicKey(publicKey: string, deps: {
+    keyRoot: string;
+    toMcpApiError: ToMcpApiError;
+}): Promise<{
+    fileName: string;
+    publicKeyPath: string;
+    privateKeyPath: string;
+}>;
+export declare function resolvePreferredManagementKeyOption(config: NodeSdkConfig, keyOptions: ManagementKeyOption[], deps: {
+    keyRoot: string;
+    toMcpApiError: ToMcpApiError;
+}): Promise<ManagementKeyOption>;
+export declare function getPrivateKeyStatus(option: ManagementKeyOption, deps: {
+    keyRoot: string;
+    toMcpApiError: ToMcpApiError;
+}): Promise<{
+    available: boolean;
+    reason?: string;
+}>;
+export declare function assertAgentCanSignManagementRequests(config: NodeSdkConfig, deps: {
+    keyRoot: string;
+    toMcpApiError: ToMcpApiError;
+}): Promise<void>;
+export declare function signManagementMessage(option: ManagementKeyOption, message: string, deps: {
+    keyRoot: string;
+    toMcpApiError: ToMcpApiError;
+    assertAgentCanSignManagementRequests: () => Promise<void>;
+    config?: NodeSdkConfig;
+}): Promise<string>;
+export declare function getManagementSigners(config: NodeSdkConfig): Promise<SdkResult<ManagementKeysResult>>;
+export declare function resolveManagementSigningKeyOption(config: NodeSdkConfig, keyOptions: ManagementKeyOption[]): Promise<SdkResult<ManagementKeyOption>>;
+export declare function getManagementSigningContext(config: NodeSdkConfig, signing: ManagementSigningMethod): Promise<SdkResult<ManagementSigningContext>>;
+export declare function buildManagementPostBody(signed: SignedManagementBody, signing: ManagementSigningMethod, canonicalJson: string): Record<string, unknown>;
+export declare function managementSignEd25519(config: NodeSdkConfig, requestFields: Record<string, unknown>, options?: ManagementSignEd25519Options): Promise<SdkResult<ManagementSignResult>>;
+export declare function managementSignEIP191(config: NodeSdkConfig, signing: EIP191ManagementSigning, requestFields: Record<string, unknown>): Promise<SdkResult<ManagementSignResult>>;
+export declare function managementSign(config: NodeSdkConfig, signing: ManagementSigningMethod, requestFields: Record<string, unknown>, options?: ManagementSignEd25519Options): Promise<SdkResult<SignedManagementBody>>;
+export declare function prepareSignedManagementRequest(config: NodeSdkConfig, signing: ManagementSigningMethod, buildRequestFields: (ctx: PrepareSignedContext) => Record<string, unknown> | Promise<Record<string, unknown>>): Promise<SdkResult<SignedManagementRequest>>;
+export declare function buildClientSigManagementPostBody(unsignedBody: Record<string, unknown>, signedMessage: string, clientSig: string): Record<string, unknown>;
+export declare function prepareActionSignedManagementRequest(config: NodeSdkConfig, signing: ManagementSigningMethod, buildRequestFields: (ctx: PrepareSignedContext) => Record<string, unknown> | Promise<Record<string, unknown>>): Promise<SdkResult<{
+    selectedSigningKey?: ManagementKeyOption;
+    signingMessage: string;
+    signature: string;
+    body: Record<string, unknown>;
+}>>;
+export declare function toSelectedSigningKey(option: ManagementKeyOption): SelectedSigningKey;
+export declare function getPreferredManagementSigner(config: NodeSdkConfig): Promise<SdkResult<{
+    publicKey: string;
+}>>;
+export declare function getManagementSigner(config: NodeSdkConfig): Promise<SdkResult<ManagementKeyResult>>;
+export declare function setPreferredManagementSigner(config: NodeSdkConfig, publicKey: string, signing?: ManagementSigningMethod): Promise<SdkEmptyResult>;
+export declare function hasEd25519ManagementSigner(config: NodeSdkConfig): Promise<SdkResult<{
+    hasEdDSAKey: boolean;
+}>>;
+/** @deprecated Use hasEd25519ManagementSigner */
+export declare const hasManagementSigner: typeof hasEd25519ManagementSigner;
+export declare function listManagementSignersDetailed(config: NodeSdkConfig): Promise<SdkResult<{
+    preferredSigner?: string;
+    keys: Array<{
+        localFileName?: string;
+        kind: 'EdDSA';
+        value: string;
+        nonce: number;
+        label?: string;
+        localPrivateKeyAvailable: boolean;
+        localPrivateKeyError?: string;
+    }>;
+}>>;
+export declare function createManagementSignerKeypair(config: NodeSdkConfig): Promise<SdkResult<{
+    success: boolean;
+    fileName: string;
+    publicKey: string;
+    privateKeyPath: string;
+    publicKeyPath: string;
+}>>;
+export declare function addManagementSigner(config: NodeSdkConfig, input: {
+    newPublicKey: string;
+}, signing?: ManagementSigningMethod): Promise<SdkResult<{
+    success: boolean;
+    publicKey: string;
+    nodeKey: string;
+}>>;
+export { MANAGEMENT_KEYS_DIR, MPA_HOME_DIR };
+//# sourceMappingURL=management-signer.d.ts.map

package/dist/detops/management-signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-signer.d.ts","sourceRoot":"","sources":["../../src/detops/management-signer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAkBvD,OAAO,EAAC,YAAY,EAAE,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,aAAa,CAAC;AAC3D,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACX,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAC,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAC,MAAM,cAAc,CAAC;AAChG,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,0BAA0B,EAAC,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,mBAAmB,EAAE,CAAC;CAC/C,CAAC;AAaF,KAAK,uBAAuB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG;IACrC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAqBF,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,aAAwB,GACrC,MAAM,CASR;AAED,wBAAgB,6BAA6B,CAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,MAAM,CAER;AAED,wBAAsB,6BAA6B,CAClD,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,aAAwB,GACrC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA4BpC;AA+CD,wBAAsB,8BAA8B,CACnD,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAC,GACnD,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAC,CAAC,CA6B5E;AAED,wBAAsB,mCAAmC,CACxD,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,mBAAmB,EAAE,EACjC,IAAI,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;CAC7B,GACC,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAC,GACnD,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC,CAUhD;AAED,wBAAsB,oCAAoC,CACzD,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;CAC7B,GACC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,oCAAoC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB,GACC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAqC1C;AAED,wBAAsB,iCAAiC,CACtD,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,mBAAmB,EAAE,GAC/B,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAOzC;AAED,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAuC9C;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,uBAAuB,EAChC,aAAa,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAE,4BAAiC,GACxC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CA8C1C;AAED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,EAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAkB1C;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,EAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAE,4BAAiC,GACxC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAc1C;AAED,wBAAsB,8BAA8B,CACnD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,EAChC,kBAAkB,EAAE,CACnB,GAAG,EAAE,oBAAoB,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7D,OAAO,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAgF7C;AAED,wBAAgB,gCAAgC,CAC/C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAsB,oCAAoC,CACzD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,uBAAuB,EAChC,kBAAkB,EAAE,CACnB,GAAG,EAAE,oBAAoB,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7D,OAAO,CACT,SAAS,CAAC;IACT,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC,CACF,CAkBA;AAED,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,mBAAmB,GACzB,kBAAkB,CAQpB;AAED,wBAAsB,4BAA4B,CACjD,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CAmBzC;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CA2BzC;AAED,wBAAsB,4BAA4B,CACjD,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAC,CAAC,CAAC,CAM5C;AAED,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,mCAA6B,CAAC;AAE9D,wBAAsB,6BAA6B,CAClD,MAAM,EAAE,aAAa,GACnB,OAAO,CACT,SAAS,CAAC;IACT,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,KAAK,CAAC;QACX,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wBAAwB,EAAE,OAAO,CAAC;QAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC,CAAC;CACH,CAAC,CACF,CA+BA;AAED,wBAAsB,6BAA6B,CAClD,MAAM,EAAE,aAAa,GACnB,OAAO,CACT,SAAS,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC,CACF,CA6CA;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC,EAC7B,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CACT,SAAS,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC,CACF,CAsDA;AAED,OAAO,EAAC,mBAAmB,EAAE,YAAY,EAAC,CAAC"}