@codama/dynamic-address-resolution 0.2.0

package/dist/types/visitors/codec-input-transformer.d.ts

@@ -0,0 +1,37 @@
+import type { BytesEncoding, RootNode, TypeNode, Visitor } from 'codama';
+/**
+ * Type nodes that the input value transformer can process.
+ * Includes all StandaloneTypeNode kinds plus definedTypeLinkNode.
+ */
+export declare const CODEC_INPUT_TRANSFORMER_SUPPORTED_NODE_KINDS: readonly ["amountTypeNode", "arrayTypeNode", "booleanTypeNode", "bytesTypeNode", "dateTimeTypeNode", "definedTypeLinkNode", "enumTypeNode", "fixedSizeTypeNode", "hiddenPrefixTypeNode", "hiddenSuffixTypeNode", "mapTypeNode", "numberTypeNode", "optionTypeNode", "postOffsetTypeNode", "preOffsetTypeNode", "publicKeyTypeNode", "remainderOptionTypeNode", "sentinelTypeNode", "setTypeNode", "sizePrefixTypeNode", "solAmountTypeNode", "stringTypeNode", "structFieldTypeNode", "structTypeNode", "tupleTypeNode", "zeroableOptionTypeNode"];
+export type TransformableTypeNodeKind = (typeof CODEC_INPUT_TRANSFORMER_SUPPORTED_NODE_KINDS)[number];
+export type CodecInputTransformerOptions = {
+    bytesEncoding?: BytesEncoding;
+};
+/**
+ * A transformer function that converts user input to Codama codec-compatible format.
+ */
+export type CodecInputTransformer = (input: unknown) => unknown;
+export declare function createCodecInputTransformerVisitor(root: RootNode, options?: CodecInputTransformerOptions): Visitor<CodecInputTransformer, TransformableTypeNodeKind>;
+/**
+ * Creates a transformer function that converts user input to codec-compatible input format.
+ * For example: user input Uint8Array for binary data but @codama/dynamic-codecs expects [BytesEncoding, string] as input
+ *
+ * @param typeNode - The Codama type node describing the expected structure
+ * @param root - Root node for resolving definedTypeLinkNode references
+ * @param options - Configuration options (encoding preference)
+ * @returns Transformer function that converts input to codec format
+ *
+ * @example
+ * const transformer = createCodecInputTransformer(
+ *     bytesTypeNode(),
+ *     root,
+ *     { bytesEncoding: 'base16' }
+ * );
+ *
+ * const input = new Uint8Array([72, 101, 108, 108, 111]);
+ * const transformed = transformer(input); // => ['base16', '48656c6c6f']
+ * Usage with codec: codamaCodec.encode(['base16', '48656c6c6f'])
+ */
+export declare function createCodecInputTransformer(typeNode: TypeNode, root: RootNode, options?: CodecInputTransformerOptions): CodecInputTransformer;
+//# sourceMappingURL=codec-input-transformer.d.ts.map

package/dist/types/visitors/codec-input-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-input-transformer.d.ts","sourceRoot":"","sources":["../../../src/visitors/codec-input-transformer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAQ,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAM/E;;;GAGG;AACH,eAAO,MAAM,4CAA4C,ohBA2B/C,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,4CAA4C,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtG,MAAM,MAAM,4BAA4B,GAAG;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAUhE,wBAAgB,kCAAkC,CAC9C,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,4BAAiC,GAC3C,OAAO,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAqR3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,4BAA4B,GACvC,qBAAqB,CAGvB"}

package/dist/types/visitors/condition-node-value.d.ts

@@ -0,0 +1,12 @@
+import type { Visitor } from 'codama';
+import type { BaseResolutionContext } from '../resolvers/types';
+import type { AccountsInput, ArgumentsInput, ResolverFnInput, ResolversInput } from '../shared/types';
+export declare const CONDITION_NODE_SUPPORTED_NODE_KINDS: readonly ["accountValueNode", "argumentValueNode", "resolverValueNode"];
+type ConditionNodeSupportedNodeKind = (typeof CONDITION_NODE_SUPPORTED_NODE_KINDS)[number];
+/**
+ * Visitor for resolving condition nodes in ConditionalValueNode.
+ * Returns the runtime value of the condition (from accounts or arguments).
+ */
+export declare function createConditionNodeValueVisitor<TAccounts extends AccountsInput = AccountsInput, TArgs extends ArgumentsInput = ArgumentsInput, TResolvers extends ResolverFnInput = ResolversInput>(ctx: BaseResolutionContext<TAccounts, TArgs, TResolvers>): Visitor<Promise<unknown>, ConditionNodeSupportedNodeKind>;
+export {};
+//# sourceMappingURL=condition-node-value.d.ts.map

package/dist/types/visitors/condition-node-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-node-value.d.ts","sourceRoot":"","sources":["../../../src/visitors/condition-node-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtG,eAAO,MAAM,mCAAmC,yEAItC,CAAC;AAEX,KAAK,8BAA8B,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,+BAA+B,CAC3C,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,eAAe,GAAG,cAAc,EACrD,GAAG,EAAE,qBAAqB,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,8BAA8B,CAAC,CA8CrH"}

package/dist/types/visitors/default-value-encoder.d.ts

@@ -0,0 +1,16 @@
+import type { ReadonlyUint8Array } from '@solana/codecs';
+import type { Visitor } from 'codama';
+export declare const DEFAULT_VALUE_ENCODER_SUPPORTED_NODE_KINDS: readonly ["booleanValueNode", "bytesValueNode", "enumValueNode", "noneValueNode", "numberValueNode", "publicKeyValueNode", "stringValueNode"];
+type DefaultValueEncoderSupportedNodeKind = (typeof DEFAULT_VALUE_ENCODER_SUPPORTED_NODE_KINDS)[number];
+/**
+ * Visitor for encoding default (omitted) values for instruction arguments.
+ *
+ * Today, Anchor/Codama primarily uses omitted defaults for discriminators
+ * (`bytesValueNode`), but this visitor is intentionally extensible as we
+ * expand node coverage over time.
+ */
+export declare function createDefaultValueEncoderVisitor(codec: {
+    encode: (value: unknown) => ReadonlyUint8Array;
+}): Visitor<ReadonlyUint8Array, DefaultValueEncoderSupportedNodeKind>;
+export {};
+//# sourceMappingURL=default-value-encoder.d.ts.map

package/dist/types/visitors/default-value-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-value-encoder.d.ts","sourceRoot":"","sources":["../../../src/visitors/default-value-encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAUtC,eAAO,MAAM,0CAA0C,+IAQ7C,CAAC;AAEX,KAAK,oCAAoC,GAAG,CAAC,OAAO,0CAA0C,CAAC,CAAC,MAAM,CAAC,CAAC;AAExG;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACpD,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,kBAAkB,CAAC;CAClD,GAAG,OAAO,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAUpE"}

package/dist/types/visitors/index.d.ts

@@ -0,0 +1,7 @@
+export { createAccountDefaultValueVisitor } from './account-default-value';
+export { createConditionNodeValueVisitor } from './condition-node-value';
+export { createDefaultValueEncoderVisitor, DEFAULT_VALUE_ENCODER_SUPPORTED_NODE_KINDS } from './default-value-encoder';
+export { createPdaSeedValueVisitor, PDA_SEED_VALUE_SUPPORTED_NODE_KINDS } from './pda-seed-value';
+export { createValueNodeVisitor } from './value-node-value';
+export { createCodecInputTransformer, createCodecInputTransformerVisitor } from './codec-input-transformer';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/visitors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/visitors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,gCAAgC,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC;AACvH,OAAO,EAAE,yBAAyB,EAAE,mCAAmC,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/visitors/pda-seed-value.d.ts

@@ -0,0 +1,20 @@
+import type { Address } from '@solana/addresses';
+import type { ReadonlyUint8Array } from '@solana/codecs';
+import type { TypeNode, Visitor } from 'codama';
+import type { BaseResolutionContext } from '../resolvers/types';
+export declare const PDA_SEED_VALUE_SUPPORTED_NODE_KINDS: readonly ["accountValueNode", "argumentValueNode", "booleanValueNode", "bytesValueNode", "constantValueNode", "noneValueNode", "numberValueNode", "programIdValueNode", "publicKeyValueNode", "someValueNode", "stringValueNode"];
+type PdaSeedValueSupportedNodeKind = (typeof PDA_SEED_VALUE_SUPPORTED_NODE_KINDS)[number];
+type PdaSeedValueVisitorContext = BaseResolutionContext & {
+    programId: Address;
+    seedTypeNode?: TypeNode;
+};
+/**
+ * Visitor for resolving PdaSeedValueNode value to raw bytes.
+ * Supports recursive resolution of dependent PDAs (accounts that are themselves auto-derived PDAs).
+ * This is used for both:
+ * - Variable seeds (e.g. seeds based on instruction accounts/arguments), and
+ * - Constant seeds (e.g. bytes/string/programId/publicKey constants).
+ */
+export declare function createPdaSeedValueVisitor(ctx: PdaSeedValueVisitorContext): Visitor<Promise<ReadonlyUint8Array>, PdaSeedValueSupportedNodeKind>;
+export {};
+//# sourceMappingURL=pda-seed-value.d.ts.map

package/dist/types/visitors/pda-seed-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda-seed-value.d.ts","sourceRoot":"","sources":["../../../src/visitors/pda-seed-value.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAYR,QAAQ,EACR,OAAO,EACV,MAAM,QAAQ,CAAC;AAIhB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAMhE,eAAO,MAAM,mCAAmC,mOAYtC,CAAC;AAEX,KAAK,6BAA6B,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1F,KAAK,0BAA0B,GAAG,qBAAqB,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,GAAG,EAAE,0BAA0B,GAChC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,6BAA6B,CAAC,CA+GrE"}

package/dist/types/visitors/value-node-value.d.ts

@@ -0,0 +1,14 @@
+import type { Visitor } from 'codama';
+type ResolvedValue = {
+    encoding?: string;
+    kind: string;
+    value: unknown;
+};
+export declare const VALUE_NODE_SUPPORTED_NODE_KINDS: readonly ["arrayValueNode", "booleanValueNode", "bytesValueNode", "constantValueNode", "enumValueNode", "mapValueNode", "noneValueNode", "numberValueNode", "publicKeyValueNode", "setValueNode", "someValueNode", "stringValueNode", "structValueNode", "tupleValueNode"];
+type ValueNodeSupportedNodeKind = (typeof VALUE_NODE_SUPPORTED_NODE_KINDS)[number];
+/**
+ * Visitor for resolving regular ValueNode types to their typed values.
+ */
+export declare function createValueNodeVisitor(): Visitor<ResolvedValue, ValueNodeSupportedNodeKind>;
+export {};
+//# sourceMappingURL=value-node-value.d.ts.map

package/dist/types/visitors/value-node-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-node-value.d.ts","sourceRoot":"","sources":["../../../src/visitors/value-node-value.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAmBtC,KAAK,aAAa,GAAG;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,+BAA+B,4QAelC,CAAC;AAEX,KAAK,0BAA0B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAuI3F"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@codama/dynamic-address-resolution",
+  "version": "0.2.0",
+  "description": "Address resolution functionality for instruction accounts in Codama IDLs",
+  "exports": {
+    "types": "./dist/types/index.d.ts",
+    "react-native": "./dist/index.react-native.mjs",
+    "browser": {
+      "import": "./dist/index.browser.mjs",
+      "require": "./dist/index.browser.cjs"
+    },
+    "node": {
+      "import": "./dist/index.node.mjs",
+      "require": "./dist/index.node.cjs"
+    }
+  },
+  "browser": {
+    "./dist/index.node.cjs": "./dist/index.browser.cjs",
+    "./dist/index.node.mjs": "./dist/index.browser.mjs"
+  },
+  "main": "./dist/index.node.cjs",
+  "module": "./dist/index.node.mjs",
+  "react-native": "./dist/index.react-native.mjs",
+  "types": "./dist/types/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "./dist/types",
+    "./dist/index.*"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "solana",
+    "framework",
+    "standard",
+    "specifications",
+    "address-resolution"
+  ],
+  "dependencies": {
+    "@solana/addresses": "^5.3.0",
+    "@solana/codecs": "^5.3.0",
+    "@codama/dynamic-codecs": "1.2.1",
+    "@codama/errors": "1.7.0",
+    "codama": "1.7.0"
+  },
+  "devDependencies": {
+    "@solana/kit": "6.5.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codama-idl/codama",
+    "directory": "packages/dynamic-address-resolution"
+  },
+  "bugs": {
+    "url": "http://github.com/codama-idl/codama/issues"
+  },
+  "browserslist": [
+    "supports bigint and not dead",
+    "maintained node versions"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
+    "dev": "vitest --project node",
+    "lint": "eslint . && prettier --check .",
+    "lint:fix": "eslint --fix . && prettier --write .",
+    "test": "pnpm test:types && pnpm test:treeshakability && pnpm test:unit",
+    "test:treeshakability": "for file in dist/index.*.mjs; do agadoo $file; done",
+    "test:types": "tsc --noEmit",
+    "test:unit": "vitest run"
+  }
+}