@haneullabs/wallet-sdk 0.1.0

package/dist/esm/auto-approvals/schemas/policy.js

@@ -0,0 +1,49 @@
+import * as v from "valibot";
+const AccessLevelSchema = v.union([v.literal("read"), v.literal("mutate"), v.literal("transfer")]);
+const BasePermissionSchema = v.object({
+  description: v.string()
+});
+const ObjectTypePermissionSchema = v.object({
+  ...BasePermissionSchema.entries,
+  $kind: v.literal("ObjectType"),
+  objectType: v.string(),
+  accessLevel: AccessLevelSchema
+});
+const CoinBalancePermissionSchema = v.object({
+  ...BasePermissionSchema.entries,
+  $kind: v.literal("CoinBalance"),
+  coinType: v.string()
+});
+const AnyBalancesPermissionSchema = v.object({
+  ...BasePermissionSchema.entries,
+  $kind: v.literal("AnyBalance")
+});
+const AutoApprovalOperationSchema = v.object({
+  id: v.string(),
+  description: v.string(),
+  permissions: v.object({
+    ownedObjects: v.optional(v.array(ObjectTypePermissionSchema)),
+    balances: v.optional(v.array(CoinBalancePermissionSchema)),
+    anyBalance: v.optional(AnyBalancesPermissionSchema)
+  })
+});
+const AutoApprovalSettingsSchema = v.looseObject({
+  approvedOperations: v.array(v.string()),
+  expiration: v.number(),
+  // TODO: figure out a better name
+  remainingTransactions: v.nullable(v.number()),
+  sharedBudget: v.nullable(v.number()),
+  // TODO: normalize coin types
+  coinBudgets: v.record(v.string(), v.string())
+});
+const AutoApprovalPolicySchema = v.object({
+  schemaVersion: v.literal("1.0.0"),
+  operations: v.array(AutoApprovalOperationSchema),
+  // TODO: do we want to split suggested settings into a different type (not everything makes sense as a suggestion)
+  suggestedSettings: v.optional(v.partial(AutoApprovalSettingsSchema))
+});
+export {
+  AutoApprovalPolicySchema,
+  AutoApprovalSettingsSchema
+};
+//# sourceMappingURL=policy.js.map

package/dist/esm/auto-approvals/schemas/policy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/auto-approvals/schemas/policy.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport * as v from 'valibot';\n\nconst AccessLevelSchema = v.union([v.literal('read'), v.literal('mutate'), v.literal('transfer')]);\n\nconst BasePermissionSchema = v.object({\n\tdescription: v.string(),\n});\n\nconst ObjectTypePermissionSchema = v.object({\n\t...BasePermissionSchema.entries,\n\t$kind: v.literal('ObjectType'),\n\tobjectType: v.string(),\n\taccessLevel: AccessLevelSchema,\n});\n\nconst CoinBalancePermissionSchema = v.object({\n\t...BasePermissionSchema.entries,\n\t$kind: v.literal('CoinBalance'),\n\tcoinType: v.string(),\n});\n\nconst AnyBalancesPermissionSchema = v.object({\n\t...BasePermissionSchema.entries,\n\t$kind: v.literal('AnyBalance'),\n});\n\nexport type PolicyPermission = v.InferOutput<\n\t| typeof CoinBalancePermissionSchema\n\t| typeof AnyBalancesPermissionSchema\n\t| typeof ObjectTypePermissionSchema\n>;\n\nconst AutoApprovalOperationSchema = v.object({\n\tid: v.string(),\n\tdescription: v.string(),\n\tpermissions: v.object({\n\t\townedObjects: v.optional(v.array(ObjectTypePermissionSchema)),\n\t\tbalances: v.optional(v.array(CoinBalancePermissionSchema)),\n\t\tanyBalance: v.optional(AnyBalancesPermissionSchema),\n\t}),\n});\n\n// TODO: do we want to support custom settings\nexport const AutoApprovalSettingsSchema = v.looseObject({\n\tapprovedOperations: v.array(v.string()),\n\texpiration: v.number(),\n\t// TODO: figure out a better name\n\tremainingTransactions: v.nullable(v.number()),\n\tsharedBudget: v.nullable(v.number()),\n\t// TODO: normalize coin types\n\tcoinBudgets: v.record(v.string(), v.string()),\n});\n\nexport const AutoApprovalPolicySchema = v.object({\n\tschemaVersion: v.literal('1.0.0'),\n\toperations: v.array(AutoApprovalOperationSchema),\n\t// TODO: do we want to split suggested settings into a different type (not everything makes sense as a suggestion)\n\tsuggestedSettings: v.optional(v.partial(AutoApprovalSettingsSchema)),\n});\n\nexport type AutoApprovalSettings = v.InferOutput<typeof AutoApprovalSettingsSchema>;\nexport type AutoApprovalPolicy = v.InferOutput<typeof AutoApprovalPolicySchema>;\nexport type AutoApprovalOperation = v.InferOutput<typeof AutoApprovalOperationSchema>;\n"],
+  "mappings": "AAGA,YAAY,OAAO;AAEnB,MAAM,oBAAoB,EAAE,MAAM,CAAC,EAAE,QAAQ,MAAM,GAAG,EAAE,QAAQ,QAAQ,GAAG,EAAE,QAAQ,UAAU,CAAC,CAAC;AAEjG,MAAM,uBAAuB,EAAE,OAAO;AAAA,EACrC,aAAa,EAAE,OAAO;AACvB,CAAC;AAED,MAAM,6BAA6B,EAAE,OAAO;AAAA,EAC3C,GAAG,qBAAqB;AAAA,EACxB,OAAO,EAAE,QAAQ,YAAY;AAAA,EAC7B,YAAY,EAAE,OAAO;AAAA,EACrB,aAAa;AACd,CAAC;AAED,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC5C,GAAG,qBAAqB;AAAA,EACxB,OAAO,EAAE,QAAQ,aAAa;AAAA,EAC9B,UAAU,EAAE,OAAO;AACpB,CAAC;AAED,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC5C,GAAG,qBAAqB;AAAA,EACxB,OAAO,EAAE,QAAQ,YAAY;AAC9B,CAAC;AAQD,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC5C,IAAI,EAAE,OAAO;AAAA,EACb,aAAa,EAAE,OAAO;AAAA,EACtB,aAAa,EAAE,OAAO;AAAA,IACrB,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAAA,IAC5D,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAAA,IACzD,YAAY,EAAE,SAAS,2BAA2B;AAAA,EACnD,CAAC;AACF,CAAC;AAGM,MAAM,6BAA6B,EAAE,YAAY;AAAA,EACvD,oBAAoB,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA,EACtC,YAAY,EAAE,OAAO;AAAA;AAAA,EAErB,uBAAuB,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EAC5C,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA;AAAA,EAEnC,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC;AAC7C,CAAC;AAEM,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAChD,eAAe,EAAE,QAAQ,OAAO;AAAA,EAChC,YAAY,EAAE,MAAM,2BAA2B;AAAA;AAAA,EAE/C,mBAAmB,EAAE,SAAS,EAAE,QAAQ,0BAA0B,CAAC;AACpE,CAAC;",
+  "names": []
+}

package/dist/esm/auto-approvals/schemas/state.d.ts

@@ -0,0 +1,115 @@
+import * as v from 'valibot';
+export declare const CreatedObjectSchema: v.ObjectSchema<{
+    readonly objectId: v.StringSchema<undefined>;
+    readonly version: v.StringSchema<undefined>;
+    readonly digest: v.StringSchema<undefined>;
+    readonly objectType: v.StringSchema<undefined>;
+}, undefined>;
+export declare const AutoApprovalStateSchema: v.ObjectSchema<{
+    readonly schemaVersion: v.LiteralSchema<"1.0.0", undefined>;
+    readonly policy: v.ObjectSchema<{
+        readonly schemaVersion: v.LiteralSchema<"1.0.0", undefined>;
+        readonly operations: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly permissions: v.ObjectSchema<{
+                readonly ownedObjects: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly $kind: v.LiteralSchema<"ObjectType", undefined>;
+                    readonly objectType: v.StringSchema<undefined>;
+                    readonly accessLevel: v.UnionSchema<[v.LiteralSchema<"read", undefined>, v.LiteralSchema<"mutate", undefined>, v.LiteralSchema<"transfer", undefined>], undefined>;
+                    readonly description: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly balances: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly $kind: v.LiteralSchema<"CoinBalance", undefined>;
+                    readonly coinType: v.StringSchema<undefined>;
+                    readonly description: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+                readonly anyBalance: v.OptionalSchema<v.ObjectSchema<{
+                    readonly $kind: v.LiteralSchema<"AnyBalance", undefined>;
+                    readonly description: v.StringSchema<undefined>;
+                }, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>, undefined>;
+        readonly suggestedSettings: v.OptionalSchema<Omit<v.LooseObjectSchema<{
+            readonly approvedOperations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly expiration: v.NumberSchema<undefined>;
+            readonly remainingTransactions: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+            readonly sharedBudget: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+            readonly coinBudgets: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+        }, undefined>, "entries" | "~types" | "~run" | "~standard"> & {
+            readonly entries: {
+                readonly approvedOperations: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly expiration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly remainingTransactions: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly sharedBudget: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly coinBudgets: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, undefined>;
+            };
+            readonly "~standard": v.StandardProps<{
+                approvedOperations?: string[] | undefined;
+                expiration?: number | undefined;
+                remainingTransactions?: number | null | undefined;
+                sharedBudget?: number | null | undefined;
+                coinBudgets?: {
+                    [x: string]: string;
+                } | undefined;
+            } & {
+                [key: string]: unknown;
+            }, {
+                approvedOperations?: string[] | undefined;
+                expiration?: number | undefined;
+                remainingTransactions?: number | null | undefined;
+                sharedBudget?: number | null | undefined;
+                coinBudgets?: {
+                    [x: string]: string;
+                } | undefined;
+            } & {
+                [key: string]: unknown;
+            }>;
+            readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+                approvedOperations?: string[] | undefined;
+                expiration?: number | undefined;
+                remainingTransactions?: number | null | undefined;
+                sharedBudget?: number | null | undefined;
+                coinBudgets?: {
+                    [x: string]: string;
+                } | undefined;
+            } & {
+                [key: string]: unknown;
+            }, v.StringIssue | v.ArrayIssue | v.NumberIssue | v.RecordIssue | v.LooseObjectIssue>;
+            readonly "~types"?: {
+                readonly input: {
+                    approvedOperations?: string[] | undefined;
+                    expiration?: number | undefined;
+                    remainingTransactions?: number | null | undefined;
+                    sharedBudget?: number | null | undefined;
+                    coinBudgets?: {
+                        [x: string]: string;
+                    } | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                readonly output: {
+                    approvedOperations?: string[] | undefined;
+                    expiration?: number | undefined;
+                    remainingTransactions?: number | null | undefined;
+                    sharedBudget?: number | null | undefined;
+                    coinBudgets?: {
+                        [x: string]: string;
+                    } | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                readonly issue: v.StringIssue | v.ArrayIssue | v.NumberIssue | v.RecordIssue | v.LooseObjectIssue;
+            } | undefined;
+        }, undefined>;
+    }, undefined>;
+    readonly settings: v.NullableSchema<v.LooseObjectSchema<{
+        readonly approvedOperations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly expiration: v.NumberSchema<undefined>;
+        readonly remainingTransactions: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sharedBudget: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly coinBudgets: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly pendingDigests: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type AutoApprovalState = v.InferOutput<typeof AutoApprovalStateSchema>;

package/dist/esm/auto-approvals/schemas/state.js

@@ -0,0 +1,19 @@
+import * as v from "valibot";
+import { AutoApprovalPolicySchema, AutoApprovalSettingsSchema } from "./policy.js";
+const CreatedObjectSchema = v.object({
+  objectId: v.string(),
+  version: v.string(),
+  digest: v.string(),
+  objectType: v.string()
+});
+const AutoApprovalStateSchema = v.object({
+  schemaVersion: v.literal("1.0.0"),
+  policy: AutoApprovalPolicySchema,
+  settings: v.nullable(AutoApprovalSettingsSchema),
+  pendingDigests: v.array(v.string())
+});
+export {
+  AutoApprovalStateSchema,
+  CreatedObjectSchema
+};
+//# sourceMappingURL=state.js.map

package/dist/esm/auto-approvals/schemas/state.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/auto-approvals/schemas/state.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport * as v from 'valibot';\nimport { AutoApprovalPolicySchema, AutoApprovalSettingsSchema } from './policy.js';\n\nexport const CreatedObjectSchema = v.object({\n\tobjectId: v.string(),\n\tversion: v.string(),\n\tdigest: v.string(),\n\tobjectType: v.string(),\n});\n\nexport const AutoApprovalStateSchema = v.object({\n\tschemaVersion: v.literal('1.0.0'),\n\tpolicy: AutoApprovalPolicySchema,\n\tsettings: v.nullable(AutoApprovalSettingsSchema),\n\tpendingDigests: v.array(v.string()),\n});\n\nexport type AutoApprovalState = v.InferOutput<typeof AutoApprovalStateSchema>;\n"],
+  "mappings": "AAGA,YAAY,OAAO;AACnB,SAAS,0BAA0B,kCAAkC;AAE9D,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC3C,UAAU,EAAE,OAAO;AAAA,EACnB,SAAS,EAAE,OAAO;AAAA,EAClB,QAAQ,EAAE,OAAO;AAAA,EACjB,YAAY,EAAE,OAAO;AACtB,CAAC;AAEM,MAAM,0BAA0B,EAAE,OAAO;AAAA,EAC/C,eAAe,EAAE,QAAQ,OAAO;AAAA,EAChC,QAAQ;AAAA,EACR,UAAU,EAAE,SAAS,0BAA0B;AAAA,EAC/C,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC;AACnC,CAAC;",
+  "names": []
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export * from './transaction-analyzer/index.js';
+export * from './auto-approvals/index.js';

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export * from "./transaction-analyzer/index.js";
+export * from "./auto-approvals/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nexport * from './transaction-analyzer/index.js';\nexport * from './auto-approvals/index.js';\n"],
+  "mappings": "AAGA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/package.json

@@ -0,0 +1,5 @@
+{
+  "private": true,
+  "type": "module",
+  "sideEffects": false
+}

package/dist/esm/transaction-analyzer/analyzer.d.ts

@@ -0,0 +1,34 @@
+import { Transaction } from '@haneullabs/haneul/transactions';
+import type { Defined, Simplify, UnionToIntersection } from '../util.js';
+export declare function createAnalyzer<T extends Defined, Deps extends Record<string, Analyzer<Defined, any, any>> = {}, Options = object>({ cacheKey, dependencies, analyze, }: {
+    cacheKey?: unknown;
+    dependencies?: Deps;
+    analyze: (options: Options, transaction: Transaction) => (analysis: {
+        [k in keyof Deps]: Deps[k] extends Analyzer<infer R, any, any> ? R : never;
+    }) => Promise<AnalyzerResult<T>> | AnalyzerResult<T>;
+}): Analyzer<T, Simplify<UnionToIntersection<Options | { [k in keyof Deps]: Deps[k] extends Analyzer<any, infer O, any> ? O : never; }[keyof Deps]>>, { [k in keyof Deps]: Deps[k] extends Analyzer<infer R, any, any> ? R : never; }>;
+type OptionsFromAnalyzers<T extends Record<string, Analyzer<Defined, any, any>>> = Simplify<{
+    [K in keyof T]: T[K] extends Analyzer<Defined, infer O, any> ? O : never;
+}[keyof T] & {
+    transaction: string | Uint8Array;
+}>;
+export declare function analyze<T extends Record<string, Analyzer<Defined, any, any>>>(analyzers: T, { transaction, ...options }: OptionsFromAnalyzers<T>): Promise<{ [k in keyof T]: T[k] extends Analyzer<infer R extends Defined, any, any> ? AnalyzerResult<R> : never; }>;
+export type Analyzer<T extends Defined, Options = object, Analysis extends Record<string, Defined> = {}> = {
+    cacheKey?: unknown;
+    dependencies: {
+        [k in keyof Analysis]: Analyzer<Analysis[k], Options>;
+    };
+    analyze: (options: Options, transaction: Transaction) => (analysis: Analysis) => AnalyzerResult<T> | Promise<AnalyzerResult<T>>;
+};
+export type AnalyzerResult<T extends Defined = Defined> = {
+    result: T;
+    issues?: never;
+} | {
+    issues: TransactionAnalysisIssue[];
+    result?: never;
+};
+export interface TransactionAnalysisIssue {
+    message: string;
+    error?: Error;
+}
+export {};

package/dist/esm/transaction-analyzer/analyzer.js

@@ -0,0 +1,74 @@
+import { Transaction } from "@haneullabs/haneul/transactions";
+function createAnalyzer({
+  cacheKey,
+  dependencies,
+  analyze: analyze2
+}) {
+  return {
+    cacheKey,
+    dependencies,
+    analyze: analyze2
+  };
+}
+async function analyze(analyzers, { transaction, ...options }) {
+  const tx = Transaction.from(transaction);
+  const analyzerMap = /* @__PURE__ */ new Map();
+  function initializeAnalyzer(analyzer) {
+    const cacheKey = analyzer.cacheKey ?? analyzer;
+    if (!analyzerMap.has(cacheKey)) {
+      const deps = analyzer.dependencies || {};
+      analyzerMap.set(cacheKey, analyzer.analyze(options, tx));
+      Object.values(deps).forEach((dep) => initializeAnalyzer(dep));
+    }
+    return analyzerMap.get(cacheKey);
+  }
+  Object.values(analyzers).forEach((analyzer) => initializeAnalyzer(analyzer));
+  const analysisMap = /* @__PURE__ */ new Map();
+  async function runAnalyzer(analyzer) {
+    const deps = Object.fromEntries(
+      await Promise.all(
+        Object.entries(analyzer.dependencies || {}).map(
+          async ([key, dep]) => [key, await getAnalysis(dep)]
+        )
+      )
+    );
+    const issues = /* @__PURE__ */ new Set();
+    for (const dep of Object.values(deps)) {
+      if (dep.issues) {
+        dep.issues.forEach((issue) => issues.add(issue));
+      }
+    }
+    if (issues.size) {
+      return { issues: [...issues] };
+    }
+    try {
+      const result = await analyzerMap.get(analyzer.cacheKey ?? analyzer)(
+        Object.fromEntries(Object.entries(deps).map(([key, dep]) => [key, dep.result]))
+      );
+      return result;
+    } catch (error) {
+      return {
+        issues: [
+          { message: `Unexpected error while analyzing transaction: ${error.message}` }
+        ]
+      };
+    }
+  }
+  function getAnalysis(analyzer) {
+    const cacheKey = analyzer.cacheKey ?? analyzer;
+    if (!analysisMap.has(cacheKey)) {
+      analysisMap.set(cacheKey, runAnalyzer(analyzer));
+    }
+    return analysisMap.get(cacheKey);
+  }
+  return Object.fromEntries(
+    await Promise.all(
+      Object.entries(analyzers).map(async ([key, analyzer]) => [key, await getAnalysis(analyzer)])
+    )
+  );
+}
+export {
+  analyze,
+  createAnalyzer
+};
+//# sourceMappingURL=analyzer.js.map

package/dist/esm/transaction-analyzer/analyzer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transaction-analyzer/analyzer.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n/* eslint-disable @typescript-eslint/ban-types */\n\nimport { Transaction } from '@haneullabs/haneul/transactions';\nimport type { Defined, Simplify, UnionToIntersection } from '../util.js';\n\nexport function createAnalyzer<\n\tT extends Defined,\n\tDeps extends Record<string, Analyzer<Defined, any, any>> = {},\n\tOptions = object,\n>({\n\tcacheKey,\n\tdependencies,\n\tanalyze,\n}: {\n\tcacheKey?: unknown;\n\tdependencies?: Deps;\n\tanalyze: (\n\t\toptions: Options,\n\t\ttransaction: Transaction,\n\t) => (analysis: {\n\t\t[k in keyof Deps]: Deps[k] extends Analyzer<infer R, any, any> ? R : never;\n\t}) => Promise<AnalyzerResult<T>> | AnalyzerResult<T>;\n}) {\n\treturn {\n\t\tcacheKey,\n\t\tdependencies,\n\t\tanalyze: analyze,\n\t} as Analyzer<\n\t\tT,\n\t\tSimplify<\n\t\t\tUnionToIntersection<\n\t\t\t\t| Options\n\t\t\t\t| {\n\t\t\t\t\t\t[k in keyof Deps]: Deps[k] extends Analyzer<any, infer O, any> ? O : never;\n\t\t\t\t  }[keyof Deps]\n\t\t\t>\n\t\t>,\n\t\t{\n\t\t\t[k in keyof Deps]: Deps[k] extends Analyzer<infer R, any, any> ? R : never;\n\t\t}\n\t>;\n}\n\ntype OptionsFromAnalyzers<T extends Record<string, Analyzer<Defined, any, any>>> = Simplify<\n\t{\n\t\t[K in keyof T]: T[K] extends Analyzer<Defined, infer O, any> ? O : never;\n\t}[keyof T] & {\n\t\ttransaction: string | Uint8Array;\n\t}\n>;\n\nexport async function analyze<T extends Record<string, Analyzer<Defined, any, any>>>(\n\tanalyzers: T,\n\t{ transaction, ...options }: OptionsFromAnalyzers<T>,\n) {\n\tconst tx = Transaction.from(transaction);\n\tconst analyzerMap = new Map<\n\t\tunknown,\n\t\t(analysis: object) => AnalyzerResult | Promise<AnalyzerResult>\n\t>();\n\n\tfunction initializeAnalyzer(analyzer: Analyzer<Defined>) {\n\t\tconst cacheKey = analyzer.cacheKey ?? analyzer;\n\n\t\tif (!analyzerMap.has(cacheKey)) {\n\t\t\tconst deps: Record<string, Analyzer<Defined>> = analyzer.dependencies || {};\n\t\t\tanalyzerMap.set(cacheKey, analyzer.analyze(options, tx));\n\n\t\t\tObject.values(deps).forEach((dep) => initializeAnalyzer(dep));\n\t\t}\n\n\t\treturn analyzerMap.get(cacheKey)!;\n\t}\n\n\tObject.values(analyzers).forEach((analyzer) => initializeAnalyzer(analyzer));\n\n\tconst analysisMap = new Map<unknown, Promise<AnalyzerResult>>();\n\n\tasync function runAnalyzer(analyzer: Analyzer<Defined>): Promise<AnalyzerResult> {\n\t\tconst deps: Record<string, AnalyzerResult> = Object.fromEntries(\n\t\t\tawait Promise.all(\n\t\t\t\tObject.entries((analyzer.dependencies || {}) as Record<string, Analyzer<Defined>>).map(\n\t\t\t\t\tasync ([key, dep]) => [key, await getAnalysis(dep)],\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\n\t\tconst issues = new Set<TransactionAnalysisIssue>();\n\n\t\tfor (const dep of Object.values(deps)) {\n\t\t\tif (dep.issues) {\n\t\t\t\tdep.issues.forEach((issue) => issues.add(issue));\n\t\t\t}\n\t\t}\n\n\t\tif (issues.size) {\n\t\t\treturn { issues: [...issues] };\n\t\t}\n\n\t\ttry {\n\t\t\tconst result = await analyzerMap.get(analyzer.cacheKey ?? analyzer)!(\n\t\t\t\tObject.fromEntries(Object.entries(deps).map(([key, dep]) => [key, dep.result])),\n\t\t\t);\n\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tissues: [\n\t\t\t\t\t{ message: `Unexpected error while analyzing transaction: ${(error as Error).message}` },\n\t\t\t\t],\n\t\t\t};\n\t\t}\n\t}\n\n\tfunction getAnalysis(analyzer: Analyzer<Defined>): Promise<AnalyzerResult> {\n\t\tconst cacheKey = analyzer.cacheKey ?? analyzer;\n\n\t\tif (!analysisMap.has(cacheKey)) {\n\t\t\tanalysisMap.set(cacheKey, runAnalyzer(analyzer));\n\t\t}\n\n\t\treturn analysisMap.get(cacheKey)!;\n\t}\n\n\treturn Object.fromEntries(\n\t\tawait Promise.all(\n\t\t\tObject.entries(analyzers).map(async ([key, analyzer]) => [key, await getAnalysis(analyzer)]),\n\t\t),\n\t) as {\n\t\t[k in keyof T]: T[k] extends Analyzer<infer R, any, any> ? AnalyzerResult<R> : never;\n\t};\n}\n\nexport type Analyzer<\n\tT extends Defined,\n\tOptions = object,\n\tAnalysis extends Record<string, Defined> = {},\n> = {\n\tcacheKey?: unknown;\n\tdependencies: {\n\t\t[k in keyof Analysis]: Analyzer<Analysis[k], Options>;\n\t};\n\tanalyze: (\n\t\toptions: Options,\n\t\ttransaction: Transaction,\n\t) => (analysis: Analysis) => AnalyzerResult<T> | Promise<AnalyzerResult<T>>;\n};\n\nexport type AnalyzerResult<T extends Defined = Defined> =\n\t| {\n\t\t\tresult: T;\n\t\t\tissues?: never;\n\t  }\n\t| {\n\t\t\tissues: TransactionAnalysisIssue[];\n\t\t\tresult?: never;\n\t  };\n\nexport interface TransactionAnalysisIssue {\n\tmessage: string;\n\terror?: Error;\n}\n"],
+  "mappings": "AAIA,SAAS,mBAAmB;AAGrB,SAAS,eAId;AAAA,EACD;AAAA,EACA;AAAA,EACA,SAAAA;AACD,GASG;AACF,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA,SAASA;AAAA,EACV;AAcD;AAUA,eAAsB,QACrB,WACA,EAAE,aAAa,GAAG,QAAQ,GACzB;AACD,QAAM,KAAK,YAAY,KAAK,WAAW;AACvC,QAAM,cAAc,oBAAI,IAGtB;AAEF,WAAS,mBAAmB,UAA6B;AACxD,UAAM,WAAW,SAAS,YAAY;AAEtC,QAAI,CAAC,YAAY,IAAI,QAAQ,GAAG;AAC/B,YAAM,OAA0C,SAAS,gBAAgB,CAAC;AAC1E,kBAAY,IAAI,UAAU,SAAS,QAAQ,SAAS,EAAE,CAAC;AAEvD,aAAO,OAAO,IAAI,EAAE,QAAQ,CAAC,QAAQ,mBAAmB,GAAG,CAAC;AAAA,IAC7D;AAEA,WAAO,YAAY,IAAI,QAAQ;AAAA,EAChC;AAEA,SAAO,OAAO,SAAS,EAAE,QAAQ,CAAC,aAAa,mBAAmB,QAAQ,CAAC;AAE3E,QAAM,cAAc,oBAAI,IAAsC;AAE9D,iBAAe,YAAY,UAAsD;AAChF,UAAM,OAAuC,OAAO;AAAA,MACnD,MAAM,QAAQ;AAAA,QACb,OAAO,QAAS,SAAS,gBAAgB,CAAC,CAAuC,EAAE;AAAA,UAClF,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,MAAM,YAAY,GAAG,CAAC;AAAA,QACnD;AAAA,MACD;AAAA,IACD;AAEA,UAAM,SAAS,oBAAI,IAA8B;AAEjD,eAAW,OAAO,OAAO,OAAO,IAAI,GAAG;AACtC,UAAI,IAAI,QAAQ;AACf,YAAI,OAAO,QAAQ,CAAC,UAAU,OAAO,IAAI,KAAK,CAAC;AAAA,MAChD;AAAA,IACD;AAEA,QAAI,OAAO,MAAM;AAChB,aAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE;AAAA,IAC9B;AAEA,QAAI;AACH,YAAM,SAAS,MAAM,YAAY,IAAI,SAAS,YAAY,QAAQ;AAAA,QACjE,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;AAAA,MAC/E;AAEA,aAAO;AAAA,IACR,SAAS,OAAO;AACf,aAAO;AAAA,QACN,QAAQ;AAAA,UACP,EAAE,SAAS,iDAAkD,MAAgB,OAAO,GAAG;AAAA,QACxF;AAAA,MACD;AAAA,IACD;AAAA,EACD;AAEA,WAAS,YAAY,UAAsD;AAC1E,UAAM,WAAW,SAAS,YAAY;AAEtC,QAAI,CAAC,YAAY,IAAI,QAAQ,GAAG;AAC/B,kBAAY,IAAI,UAAU,YAAY,QAAQ,CAAC;AAAA,IAChD;AAEA,WAAO,YAAY,IAAI,QAAQ;AAAA,EAChC;AAEA,SAAO,OAAO;AAAA,IACb,MAAM,QAAQ;AAAA,MACb,OAAO,QAAQ,SAAS,EAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,MAAM,YAAY,QAAQ,CAAC,CAAC;AAAA,IAC5F;AAAA,EACD;AAGD;",
+  "names": ["analyze"]
+}

package/dist/esm/transaction-analyzer/index.d.ts

@@ -0,0 +1,9 @@
+export { analyze, createAnalyzer } from './analyzer.js';
+export type { AnalyzerResult, TransactionAnalysisIssue } from './analyzer.js';
+export type { AnalyzedCoin } from './rules/coins.js';
+export type { AnalyzedCommandArgument, AnalyzedCommand } from './rules/commands.js';
+export type { AnalyzedObject } from './rules/objects.js';
+export type { CoinFlow } from './rules/coin-flows.js';
+export type { CoinValueAnalyzerOptions, CoinValueAnalysis } from './rules/coin-value.js';
+export type { AnalyzedCommandInput } from './rules/inputs.js';
+export { analyzers } from './rules/index.js';

package/dist/esm/transaction-analyzer/index.js

@@ -0,0 +1,8 @@
+import { analyze, createAnalyzer } from "./analyzer.js";
+import { analyzers } from "./rules/index.js";
+export {
+  analyze,
+  analyzers,
+  createAnalyzer
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/transaction-analyzer/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transaction-analyzer/index.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nexport { analyze, createAnalyzer } from './analyzer.js';\nexport type { AnalyzerResult, TransactionAnalysisIssue } from './analyzer.js';\n\nexport type { AnalyzedCoin } from './rules/coins.js';\nexport type { AnalyzedCommandArgument, AnalyzedCommand } from './rules/commands.js';\nexport type { AnalyzedObject } from './rules/objects.js';\nexport type { CoinFlow } from './rules/coin-flows.js';\nexport type { CoinValueAnalyzerOptions, CoinValueAnalysis } from './rules/coin-value.js';\nexport type { AnalyzedCommandInput } from './rules/inputs.js';\n\nexport { analyzers } from './rules/index.js';\n"],
+  "mappings": "AAGA,SAAS,SAAS,sBAAsB;AAUxC,SAAS,iBAAiB;",
+  "names": []
+}

package/dist/esm/transaction-analyzer/rules/accessLevel.d.ts

@@ -0,0 +1,29 @@
+export declare const accessLevel: import("../analyzer.js").Analyzer<Record<string, "read" | "mutate" | "transfer">, {
+    client: import("@haneullabs/haneul/dist/cjs/experimental/client.js").Experimental_BaseClient & {
+        core: import("@haneullabs/haneul/dist/cjs/experimental/core.js").Experimental_CoreClient;
+    };
+}, {
+    commands: import("./commands.js").AnalyzedCommand[];
+    objects: {
+        ownerAddress: string | null;
+        id: string;
+        version: string;
+        digest: string;
+        owner: import("@haneullabs/haneul/dist/cjs/experimental/types.js").Experimental_HaneulClientTypes.ObjectOwner;
+        type: string;
+        content: PromiseLike<Uint8Array>;
+        previousTransaction: string | null;
+    }[];
+    gasCoins: {
+        coinType: string;
+        balance: bigint;
+        ownerAddress: string | null;
+        id: string;
+        version: string;
+        digest: string;
+        owner: import("@haneullabs/haneul/dist/cjs/experimental/types.js").Experimental_HaneulClientTypes.ObjectOwner;
+        type: string;
+        content: PromiseLike<Uint8Array>;
+        previousTransaction: string | null;
+    }[];
+}>;

package/dist/esm/transaction-analyzer/rules/accessLevel.js

@@ -0,0 +1,86 @@
+import { createAnalyzer } from "../analyzer.js";
+import { gasCoins } from "./coins.js";
+import { commands } from "./commands.js";
+import { objects } from "./objects.js";
+const accessLevel = createAnalyzer({
+  dependencies: { commands, objects, gasCoins },
+  analyze: () => async ({ commands: commands2, objects: objects2, gasCoins: gasCoins2 }) => {
+    const issues = [];
+    const gasCoinIds = new Set(gasCoins2.map((g) => g.id));
+    const accessLevels = Object.fromEntries(
+      objects2.map((obj) => [obj.id, "read"])
+    );
+    for (const id of gasCoinIds) {
+      accessLevels[id] = "mutate";
+    }
+    for (const command of commands2) {
+      switch (command.$kind) {
+        case "TransferObjects":
+          for (const obj of command.objects) {
+            updateFromArgument(obj);
+          }
+          break;
+        case "MoveCall":
+          for (const arg of command.arguments) {
+            updateFromArgument(arg);
+          }
+          break;
+        case "SplitCoins":
+          updateFromArgument(command.coin);
+          break;
+        case "MergeCoins":
+          updateFromArgument(command.destination);
+          for (const src of command.sources) {
+            updateFromArgument(src);
+          }
+          break;
+        case "MakeMoveVec":
+          for (const el of command.elements) {
+            updateFromArgument(el);
+          }
+          break;
+        case "Upgrade":
+          updateFromArgument(command.ticket);
+          break;
+        case "Publish":
+          break;
+        default:
+          issues.push({ message: `Unknown command type: ${JSON.stringify(command)}` });
+      }
+    }
+    if (issues.length) {
+      return { issues };
+    }
+    return {
+      result: accessLevels
+    };
+    function updateFromArgument(arg) {
+      switch (arg.$kind) {
+        case "GasCoin":
+          for (const id of gasCoinIds) {
+            updateAccessLevel(id, arg.accessLevel);
+          }
+          break;
+        case "Object":
+          updateAccessLevel(arg.object.id, arg.accessLevel);
+          break;
+      }
+    }
+    function updateAccessLevel(id, level) {
+      const current = accessLevels[id];
+      if (current === "transfer") {
+        return;
+      } else if (current === "mutate") {
+        if (level === "transfer") {
+          accessLevels[id] = "transfer";
+        }
+      } else {
+        accessLevels[id] = level;
+      }
+    }
+  }
+});
+export {
+  accessLevel
+};
+//# sourceMappingURL=accessLevel.js.map

package/dist/esm/transaction-analyzer/rules/accessLevel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transaction-analyzer/rules/accessLevel.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { TransactionAnalysisIssue } from '../analyzer.js';\nimport { createAnalyzer } from '../analyzer.js';\nimport { gasCoins } from './coins.js';\nimport type { AnalyzedCommandArgument } from './commands.js';\nimport { commands } from './commands.js';\nimport { objects } from './objects.js';\n\nexport const accessLevel = createAnalyzer({\n\tdependencies: { commands, objects, gasCoins },\n\tanalyze:\n\t\t() =>\n\t\tasync ({ commands, objects, gasCoins }) => {\n\t\t\tconst issues: TransactionAnalysisIssue[] = [];\n\n\t\t\tconst gasCoinIds = new Set(gasCoins.map((g) => g.id));\n\n\t\t\tconst accessLevels: Record<string, 'read' | 'mutate' | 'transfer'> = Object.fromEntries(\n\t\t\t\tobjects.map((obj) => [obj.id, 'read' as const]),\n\t\t\t);\n\n\t\t\tfor (const id of gasCoinIds) {\n\t\t\t\taccessLevels[id] = 'mutate';\n\t\t\t}\n\n\t\t\tfor (const command of commands) {\n\t\t\t\tswitch (command.$kind) {\n\t\t\t\t\tcase 'TransferObjects':\n\t\t\t\t\t\tfor (const obj of command.objects) {\n\t\t\t\t\t\t\tupdateFromArgument(obj);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'MoveCall':\n\t\t\t\t\t\tfor (const arg of command.arguments) {\n\t\t\t\t\t\t\tupdateFromArgument(arg);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'SplitCoins':\n\t\t\t\t\t\tupdateFromArgument(command.coin);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'MergeCoins':\n\t\t\t\t\t\tupdateFromArgument(command.destination);\n\t\t\t\t\t\tfor (const src of command.sources) {\n\t\t\t\t\t\t\tupdateFromArgument(src);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'MakeMoveVec':\n\t\t\t\t\t\tfor (const el of command.elements) {\n\t\t\t\t\t\t\tupdateFromArgument(el);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'Upgrade':\n\t\t\t\t\t\tupdateFromArgument(command.ticket);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'Publish':\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tissues.push({ message: `Unknown command type: ${JSON.stringify(command)}` });\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (issues.length) {\n\t\t\t\treturn { issues };\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresult: accessLevels,\n\t\t\t};\n\n\t\t\tfunction updateFromArgument(arg: AnalyzedCommandArgument) {\n\t\t\t\tswitch (arg.$kind) {\n\t\t\t\t\tcase 'GasCoin':\n\t\t\t\t\t\tfor (const id of gasCoinIds) {\n\t\t\t\t\t\t\tupdateAccessLevel(id, arg.accessLevel);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase 'Object':\n\t\t\t\t\t\tupdateAccessLevel(arg.object.id, arg.accessLevel);\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tfunction updateAccessLevel(id: string, level: 'read' | 'mutate' | 'transfer') {\n\t\t\t\tconst current = accessLevels[id];\n\t\t\t\tif (current === 'transfer') {\n\t\t\t\t\treturn;\n\t\t\t\t} else if (current === 'mutate') {\n\t\t\t\t\tif (level === 'transfer') {\n\t\t\t\t\t\taccessLevels[id] = 'transfer';\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\taccessLevels[id] = level;\n\t\t\t\t}\n\t\t\t}\n\t\t},\n});\n"],
+  "mappings": "AAIA,SAAS,sBAAsB;AAC/B,SAAS,gBAAgB;AAEzB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AAEjB,MAAM,cAAc,eAAe;AAAA,EACzC,cAAc,EAAE,UAAU,SAAS,SAAS;AAAA,EAC5C,SACC,MACA,OAAO,EAAE,UAAAA,WAAU,SAAAC,UAAS,UAAAC,UAAS,MAAM;AAC1C,UAAM,SAAqC,CAAC;AAE5C,UAAM,aAAa,IAAI,IAAIA,UAAS,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AAEpD,UAAM,eAA+D,OAAO;AAAA,MAC3ED,SAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAe,CAAC;AAAA,IAC/C;AAEA,eAAW,MAAM,YAAY;AAC5B,mBAAa,EAAE,IAAI;AAAA,IACpB;AAEA,eAAW,WAAWD,WAAU;AAC/B,cAAQ,QAAQ,OAAO;AAAA,QACtB,KAAK;AACJ,qBAAW,OAAO,QAAQ,SAAS;AAClC,+BAAmB,GAAG;AAAA,UACvB;AACA;AAAA,QACD,KAAK;AACJ,qBAAW,OAAO,QAAQ,WAAW;AACpC,+BAAmB,GAAG;AAAA,UACvB;AACA;AAAA,QACD,KAAK;AACJ,6BAAmB,QAAQ,IAAI;AAC/B;AAAA,QACD,KAAK;AACJ,6BAAmB,QAAQ,WAAW;AACtC,qBAAW,OAAO,QAAQ,SAAS;AAClC,+BAAmB,GAAG;AAAA,UACvB;AACA;AAAA,QACD,KAAK;AACJ,qBAAW,MAAM,QAAQ,UAAU;AAClC,+BAAmB,EAAE;AAAA,UACtB;AACA;AAAA,QACD,KAAK;AACJ,6BAAmB,QAAQ,MAAM;AACjC;AAAA,QACD,KAAK;AACJ;AAAA,QACD;AACC,iBAAO,KAAK,EAAE,SAAS,yBAAyB,KAAK,UAAU,OAAO,CAAC,GAAG,CAAC;AAAA,MAC7E;AAAA,IACD;AAEA,QAAI,OAAO,QAAQ;AAClB,aAAO,EAAE,OAAO;AAAA,IACjB;AAEA,WAAO;AAAA,MACN,QAAQ;AAAA,IACT;AAEA,aAAS,mBAAmB,KAA8B;AACzD,cAAQ,IAAI,OAAO;AAAA,QAClB,KAAK;AACJ,qBAAW,MAAM,YAAY;AAC5B,8BAAkB,IAAI,IAAI,WAAW;AAAA,UACtC;AACA;AAAA,QACD,KAAK;AACJ,4BAAkB,IAAI,OAAO,IAAI,IAAI,WAAW;AAChD;AAAA,MACF;AAAA,IACD;AAEA,aAAS,kBAAkB,IAAY,OAAuC;AAC7E,YAAM,UAAU,aAAa,EAAE;AAC/B,UAAI,YAAY,YAAY;AAC3B;AAAA,MACD,WAAW,YAAY,UAAU;AAChC,YAAI,UAAU,YAAY;AACzB,uBAAa,EAAE,IAAI;AAAA,QACpB;AAAA,MACD,OAAO;AACN,qBAAa,EAAE,IAAI;AAAA,MACpB;AAAA,IACD;AAAA,EACD;AACF,CAAC;",
+  "names": ["commands", "objects", "gasCoins"]
+}