codama-renderers-dart 0.4.0 → 0.4.2

package/dist/types/fragments/accountPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/accountPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,eAAe,CAAC;AAItE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,QAAQ,CAkLV"}
+{"version":3,"file":"accountPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/accountPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,eAAe,CAAC;AAItE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,QAAQ,CA0LV"}

package/dist/types/fragments/instructionPage.d.ts

@@ -1,4 +1,4 @@
-import type { InstructionNode } from "@codama/nodes";
+import { InstructionNode } from "@codama/nodes";
 import type { Fragment } from "../utils/fragment.js";
 import type { RenderScope } from "../utils/options.js";
 /**

package/dist/types/fragments/instructionPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructionPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/instructionPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,WAAW,GACjB,QAAQ,CAoOV"}
+{"version":3,"file":"instructionPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/instructionPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,WAAW,GACjB,QAAQ,CA4PV"}

package/dist/types/fragments/pdaPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdaPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/pdaPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,WAAW,GACjB,QAAQ,CAmGV"}
+{"version":3,"file":"pdaPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/pdaPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,WAAW,GACjB,QAAQ,CAmJV"}

package/dist/types/fragments/programPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"programPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/programPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,QAAQ,CA2CV"}
+{"version":3,"file":"programPage.d.ts","sourceRoot":"","sources":["../../../src/fragments/programPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,QAAQ,CAgEV"}

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

@@ -5,4 +5,5 @@ export * from "./importMap.js";
 export * from "./nameTransformers.js";
 export * from "./options.js";
 export * from "./typeManifest.js";
+export * from "./wellKnownAddresses.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/types/utils/wellKnownAddresses.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Maps well-known Solana public keys to their canonical Dart constant names
+ * in `package:solana_kit_addresses`. When the renderer encounters a known
+ * address, it emits a re-export from that package instead of hardcoding the
+ * address string.
+ *
+ * The keys are the base-58 public key strings as they appear in IDL/Codama nodes.
+ * The values are the Dart constant names exported by `solana_kit_addresses`.
+ */
+export declare const WELL_KNOWN_ADDRESSES: ReadonlyMap<string, string>;
+//# sourceMappingURL=wellKnownAddresses.d.ts.map

package/dist/types/utils/wellKnownAddresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wellKnownAddresses.d.ts","sourceRoot":"","sources":["../../../src/utils/wellKnownAddresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAsD3D,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"getRenderMapVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getRenderMapVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,OAAO,EASb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AAa5E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC,CAkO9H"}
+{"version":3,"file":"getRenderMapVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getRenderMapVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,OAAO,EASb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AAa5E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC,CAwK9H"}

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

@@ -15,5 +15,5 @@ export declare function getTypeManifestVisitor(input: {
     linkables: LinkableDictionary;
     stack: NodeStack;
     nonScalarEnums?: CamelCaseString[];
-}): Visitor<TypeManifest, "accountNode" | "definedTypeNode" | "errorNode" | "instructionAccountNode" | "instructionArgumentNode" | "instructionByteDeltaNode" | "instructionNode" | "instructionRemainingAccountsNode" | "instructionStatusNode" | "pdaNode" | "programNode" | "pdaSeedValueNode" | "accountBumpValueNode" | "accountValueNode" | "argumentValueNode" | "conditionalValueNode" | "identityValueNode" | "payerValueNode" | "pdaValueNode" | "programIdValueNode" | "resolverValueNode" | "fixedCountNode" | "prefixedCountNode" | "remainderCountNode" | "constantDiscriminatorNode" | "fieldDiscriminatorNode" | "sizeDiscriminatorNode" | "accountLinkNode" | "definedTypeLinkNode" | "instructionAccountLinkNode" | "instructionArgumentLinkNode" | "instructionLinkNode" | "pdaLinkNode" | "programLinkNode" | "constantPdaSeedNode" | "variablePdaSeedNode" | "enumEmptyVariantTypeNode" | "enumStructVariantTypeNode" | "enumTupleVariantTypeNode" | "amountTypeNode" | "arrayTypeNode" | "booleanTypeNode" | "bytesTypeNode" | "dateTimeTypeNode" | "enumTypeNode" | "fixedSizeTypeNode" | "hiddenPrefixTypeNode" | "hiddenSuffixTypeNode" | "mapTypeNode" | "numberTypeNode" | "optionTypeNode" | "postOffsetTypeNode" | "preOffsetTypeNode" | "publicKeyTypeNode" | "remainderOptionTypeNode" | "sentinelTypeNode" | "setTypeNode" | "sizePrefixTypeNode" | "solAmountTypeNode" | "stringTypeNode" | "structTypeNode" | "tupleTypeNode" | "zeroableOptionTypeNode" | "structFieldTypeNode" | "mapEntryValueNode" | "arrayValueNode" | "booleanValueNode" | "bytesValueNode" | "constantValueNode" | "enumValueNode" | "mapValueNode" | "noneValueNode" | "numberValueNode" | "publicKeyValueNode" | "setValueNode" | "someValueNode" | "stringValueNode" | "structValueNode" | "tupleValueNode" | "structFieldValueNode" | "rootNode">;
+}): Visitor<TypeManifest, "accountNode" | "constantNode" | "definedTypeNode" | "errorNode" | "eventNode" | "instructionAccountNode" | "instructionArgumentNode" | "instructionByteDeltaNode" | "instructionNode" | "instructionRemainingAccountsNode" | "instructionStatusNode" | "pdaNode" | "programNode" | "pdaSeedValueNode" | "accountBumpValueNode" | "accountValueNode" | "argumentValueNode" | "conditionalValueNode" | "identityValueNode" | "payerValueNode" | "pdaValueNode" | "programIdValueNode" | "resolverValueNode" | "fixedCountNode" | "prefixedCountNode" | "remainderCountNode" | "constantDiscriminatorNode" | "fieldDiscriminatorNode" | "sizeDiscriminatorNode" | "accountLinkNode" | "definedTypeLinkNode" | "instructionAccountLinkNode" | "instructionArgumentLinkNode" | "instructionLinkNode" | "pdaLinkNode" | "programLinkNode" | "constantPdaSeedNode" | "variablePdaSeedNode" | "enumEmptyVariantTypeNode" | "enumStructVariantTypeNode" | "enumTupleVariantTypeNode" | "amountTypeNode" | "arrayTypeNode" | "booleanTypeNode" | "bytesTypeNode" | "dateTimeTypeNode" | "enumTypeNode" | "fixedSizeTypeNode" | "hiddenPrefixTypeNode" | "hiddenSuffixTypeNode" | "mapTypeNode" | "numberTypeNode" | "optionTypeNode" | "postOffsetTypeNode" | "preOffsetTypeNode" | "publicKeyTypeNode" | "remainderOptionTypeNode" | "sentinelTypeNode" | "setTypeNode" | "sizePrefixTypeNode" | "solAmountTypeNode" | "stringTypeNode" | "structTypeNode" | "tupleTypeNode" | "zeroableOptionTypeNode" | "structFieldTypeNode" | "mapEntryValueNode" | "arrayValueNode" | "booleanValueNode" | "bytesValueNode" | "constantValueNode" | "enumValueNode" | "mapValueNode" | "noneValueNode" | "numberValueNode" | "publicKeyValueNode" | "setValueNode" | "someValueNode" | "stringValueNode" | "structValueNode" | "tupleValueNode" | "structFieldValueNode" | "rootNode">;
 //# sourceMappingURL=getTypeManifestVisitor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getTypeManifestVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getTypeManifestVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EA8BrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,8BAA8B,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;CACpC,8vDAilBA"}
+{"version":3,"file":"getTypeManifestVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getTypeManifestVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EA8BrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,8BAA8B,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;CACpC,6xDAymBA"}

package/package.json

@@ -1,23 +1,31 @@
 {
-  "name": "codama-renderers-dart",
-  "version": "0.4.0",
+  "dependencies": {
+    "@codama/errors": "^1.4.4",
+    "@codama/nodes": "^1.4.4",
+    "@codama/renderers-core": "^1.3.3",
+    "@codama/visitors-core": "^1.4.4"
+  },
   "description": "Codama renderer for generating Dart code targeting the solana_kit SDK",
+  "devDependencies": {
+    "@codama/nodes-from-anchor": "^1.3.9",
+    "@codama/renderers-js": "^2.0.2",
+    "@vitest/coverage-v8": "4.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
-    "node": {
-      "import": "./dist/index.node.mjs",
-      "require": "./dist/index.node.cjs"
-    },
     "browser": {
       "import": "./dist/index.browser.mjs",
       "require": "./dist/index.browser.cjs"
     },
+    "node": {
+      "import": "./dist/index.node.mjs",
+      "require": "./dist/index.node.cjs"
+    },
     "react-native": "./dist/index.react-native.mjs",
     "types": "./dist/types/index.d.ts"
   },
-  "main": "./dist/index.node.cjs",
-  "module": "./dist/index.node.mjs",
-  "types": "./dist/types/index.d.ts",
-  "type": "module",
   "files": [
     "dist",
     "src"
@@ -30,28 +38,13 @@
     "code-generator"
   ],
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/openbudgetfun/solana_kit.git",
-    "directory": "packages/codama-renderers-dart"
-  },
-  "dependencies": {
-    "@codama/errors": "^1.4.4",
-    "@codama/nodes": "^1.4.4",
-    "@codama/renderers-core": "^1.3.3",
-    "@codama/visitors-core": "^1.4.4"
-  },
-  "devDependencies": {
-    "@codama/nodes-from-anchor": "^1.3.9",
-    "@codama/renderers-js": "^2.0.2",
-    "@vitest/coverage-v8": "3.2.4"
-  },
-  "engines": {
-    "node": ">=18"
-  },
+  "main": "./dist/index.node.cjs",
+  "module": "./dist/index.node.mjs",
+  "name": "codama-renderers-dart",
   "publishConfig": {
     "access": "public"
   },
+  "repository": "https://github.com/openbudgetfun/solana_kit/tree/main/packages/codama-renderers-dart",
   "scripts": {
     "build": "pnpm exec rimraf dist && pnpm exec tsup && pnpm exec tsc -p tsconfig.declarations.json",
     "lint": "eslint --ext .ts src",
@@ -59,5 +52,8 @@
     "test:coverage": "pnpm exec vitest run --coverage.enabled --coverage.reporter=lcov",
     "test:watch": "pnpm exec vitest",
     "typecheck": "pnpm exec tsc --noEmit"
-  }
-}
+  },
+  "type": "module",
+  "types": "./dist/types/index.d.ts",
+  "version": "0.4.2"
+}

package/src/fragments/accountPage.ts

@@ -44,6 +44,11 @@ export function getAccountPageFragment(
     .map((f: StructFieldTypeNode) => `    required this.${camelCase(f.name as string)},`)
     .join("\n");
 
+  // Empty structs use a no-arg constructor; `const Foo({})` is invalid Dart.
+  const ctorSignature = fields.length === 0
+    ? `const ${typeName}();`
+    : `const ${typeName}({\n${ctorParams}\n  });`;
+
   const eqChecks =
     fields.length === 0
       ? "true"
@@ -54,9 +59,14 @@ export function getAccountPageFragment(
           )
           .join(" &&\n          ");
 
-  const hashFields = fields
-    .map((f: StructFieldTypeNode) => camelCase(f.name as string))
-    .join(", ");
+  const hashFieldNames = fields.map((f: StructFieldTypeNode) => camelCase(f.name as string));
+  // `Object.hash()` requires at least two arguments, so handle 0/1 fields specially.
+  const hashCodeExpr =
+    hashFieldNames.length === 0
+      ? "0"
+      : hashFieldNames.length === 1
+        ? `${hashFieldNames[0]}.hashCode`
+        : `Object.hash(${hashFieldNames.join(", ")})`;
 
   const toStringFields = fields
     .map(
@@ -129,9 +139,7 @@ ${use("decodeAccount", "solanaAccounts")}
 
 @immutable
 class ${fragmentFromString(typeName)} {
-  const ${fragmentFromString(typeName)}({
-${fragmentFromString(ctorParams)}
-  });
+  ${fragmentFromString(ctorSignature)}
 
 ${fragmentFromString(fieldDecls)}
 
@@ -143,7 +151,7 @@ ${fragmentFromString(fieldDecls)}
           ${fragmentFromString(eqChecks)};
 
   @override
-  int get hashCode => Object.hash(${fragmentFromString(hashFields)});
+  int get hashCode => ${fragmentFromString(hashCodeExpr)};
 
   @override
   String toString() => '${fragmentFromString(typeName)}(${fragmentFromString(toStringFields)})';

package/src/fragments/instructionPage.ts

@@ -1,4 +1,4 @@
-import type {
+import {
   InstructionAccountNode,
   InstructionArgumentNode,
   InstructionNode,
@@ -16,6 +16,7 @@ import {
 import type { RenderScope } from "../utils/options.js";
 import { camelCase, pascalCase } from "../utils/nameTransformers.js";
 import { getDiscriminatorConstantsFragment } from "./discriminatorConstants.js";
+import { WELL_KNOWN_ADDRESSES } from "../utils/wellKnownAddresses.js";
 
 /**
  * Generate a full Dart file for an instruction.
@@ -338,8 +339,14 @@ function getDefaultValue(arg: InstructionArgumentNode): string {
       return String(dv.boolean);
     case "stringValueNode":
       return `'${dv.string}'`;
-    case "publicKeyValueNode":
+    case "publicKeyValueNode": {
+      const wellKnownName = WELL_KNOWN_ADDRESSES.get(dv.publicKey);
+      if (wellKnownName) {
+        use(wellKnownName, "solanaAddresses");
+        return wellKnownName;
+      }
       return `Address('${dv.publicKey}')`;
+    }
     case "noneValueNode":
       return "null";
     case "bytesValueNode": {

package/src/fragments/pdaPage.ts

@@ -10,6 +10,8 @@ import {
 } from "../utils/fragment.js";
 import type { RenderScope } from "../utils/options.js";
 import { camelCase, pascalCase } from "../utils/nameTransformers.js";
+import type { TypeManifest } from "../utils/typeManifest.js";
+import { WELL_KNOWN_ADDRESSES } from "../utils/wellKnownAddresses.js";
 
 /**
  * Generate a full Dart file for a PDA.
@@ -40,10 +42,14 @@ export function getPdaPageFragment(
   // Build seeds class if there are variable seeds
   const hasSeedsClass = variableSeeds.length > 0;
 
+  // Collect type manifests so their imports can be merged into the result.
+  const seedManifests: TypeManifest[] = [];
+
   const seedFieldDecls = variableSeeds
     .map((s) => {
       if (s.kind !== "variablePdaSeedNode") return "";
       const manifest = visit(s.type, scope.typeManifestVisitor);
+      seedManifests.push(manifest);
       return `  final ${manifest.type.content} ${camelCase(s.name as string)};`;
     })
     .join("\n");
@@ -64,15 +70,25 @@ export function getPdaPageFragment(
       } else if (seed.value.kind === "stringValueNode") {
         seedValues.push(`    '${seed.value.string}',`);
       } else if (seed.value.kind === "publicKeyValueNode") {
-        seedValues.push(
-          `    getAddressEncoder().encode(Address('${seed.value.publicKey}')),`,
-        );
+        const wellKnownSeedName = WELL_KNOWN_ADDRESSES.get(seed.value.publicKey);
+        if (wellKnownSeedName) {
+          use(wellKnownSeedName, "solanaAddresses");
+          seedValues.push(
+            `    getAddressEncoder().encode(${wellKnownSeedName}),`,
+          );
+        } else {
+          seedValues.push(
+            `    getAddressEncoder().encode(Address('${seed.value.publicKey}')),`,
+          );
+        }
       } else if (seed.value.kind === "numberValueNode") {
         const manifest = visit(seed.type, scope.typeManifestVisitor);
+        seedManifests.push(manifest);
         seedValues.push(`    ${manifest.encoder.content}.encode(${seed.value.number}),`);
       }
     } else if (seed.kind === "variablePdaSeedNode") {
       const manifest = visit(seed.type, scope.typeManifestVisitor);
+      seedManifests.push(manifest);
       seedValues.push(
         `    ${manifest.encoder.content}.encode(seeds.${camelCase(seed.name as string)}),`,
       );
@@ -80,20 +96,31 @@ export function getPdaPageFragment(
   }
 
   // Program address parameter
+  const wellKnownProgramName = node.programId
+    ? WELL_KNOWN_ADDRESSES.get(node.programId)
+    : undefined;
+  if (wellKnownProgramName) {
+    use(wellKnownProgramName, "solanaAddresses");
+  }
   const programIdParam = node.programId
-    ? `Address programAddress = const Address('${node.programId}')`
+    ? wellKnownProgramName
+      ? `Address programAddress = ${wellKnownProgramName}`
+      : `Address programAddress = const Address('${node.programId}')`
     : "required Address programAddress";
 
   const typedDataImport = hasByteSeeds
     ? use("Uint8List", "dartTypedData")
     : fragmentFromString("");
 
+  // `@immutable` is only needed when a seeds class is emitted.
+  const metaImport = hasSeedsClass ? use("immutable", "meta") : fragmentFromString("");
+
   const parts: Fragment[] = [
     fragment`// Auto-generated. Do not edit.
 // ignore_for_file: type=lint
 
 ${typedDataImport}
-${use("immutable", "meta")}
+${metaImport}
 ${use("Address", "solanaAddresses")}
 ${use("getAddressEncoder", "solanaAddresses")}
 ${use("getProgramDerivedAddress", "solanaAddresses")}`,
@@ -129,7 +156,16 @@ ${fragmentFromString(seedValues.join("\n"))}
   );
 }`);
 
-  return mergeFragments(parts, (cs) => cs.join("\n"));
+  const result = mergeFragments(parts, (cs) => cs.join("\n"));
+
+  // Merge seed type manifest imports (encoders/types) into the result so that
+  // helpers like `getU64Encoder` are imported.
+  for (const manifest of seedManifests) {
+    result.imports.mergeWith(manifest.encoder.imports);
+    result.imports.mergeWith(manifest.type.imports);
+  }
+
+  return result;
 }
 
 function bytesValueToDart(hex: string): string {

package/src/fragments/programPage.ts

@@ -10,6 +10,7 @@ import {
 } from "../utils/fragment.js";
 import type { RenderScope } from "../utils/options.js";
 import { camelCase, pascalCase } from "../utils/nameTransformers.js";
+import { WELL_KNOWN_ADDRESSES } from "../utils/wellKnownAddresses.js";
 
 /**
  * Generate a full Dart file for a program.
@@ -21,15 +22,36 @@ export function getProgramPageFragment(
   const name = node.name as string;
   const addressConstName = scope.nameApi.programAddressConstant(name);
 
-  const parts: Fragment[] = [
-    fragment`// Auto-generated. Do not edit.
+  const wellKnownName = WELL_KNOWN_ADDRESSES.get(node.publicKey);
+
+  // For well-known addresses, export and alias the canonical constant from
+  // solana_kit_addresses instead of hardcoding the address string.
+  // When the generated name matches the canonical name, a simple export suffices.
+  // When they differ, we also need a local const alias.
+  // For unknown addresses, fall back to the original Address('...') pattern.
+  const addressDeclaration: Fragment = wellKnownName
+    ? addressConstName === wellKnownName
+      ? fragment`// Auto-generated. Do not edit.
+// ignore_for_file: type=lint
+
+/// The address of the ${fragmentFromString(pascalCase(name))} program.
+export 'package:solana_kit_addresses/solana_kit_addresses.dart' show ${fragmentFromString(wellKnownName)};`
+      : fragment`${use(wellKnownName, "solanaAddresses")}
+
+// Auto-generated. Do not edit.
+// ignore_for_file: type=lint
+
+/// The address of the ${fragmentFromString(pascalCase(name))} program.
+const ${fragmentFromString(addressConstName)} = ${fragmentFromString(wellKnownName)};`
+    : fragment`// Auto-generated. Do not edit.
 // ignore_for_file: type=lint
 
 ${use("Address", "solanaAddresses")}
 
 /// The address of the ${fragmentFromString(pascalCase(name))} program.
-const ${fragmentFromString(addressConstName)} = Address('${fragmentFromString(node.publicKey)}');`,
-  ];
+const ${fragmentFromString(addressConstName)} = Address('${fragmentFromString(node.publicKey)}');`;
+
+  const parts: Fragment[] = [addressDeclaration];
 
   // Account identifier enum
   const accounts = node.accounts ?? [];
@@ -60,4 +82,4 @@ ${fragmentFromString(instrVariants)}
   }
 
   return mergeFragments(parts, (cs) => cs.join("\n"));
-}
+}

package/src/utils/index.ts

@@ -5,3 +5,4 @@ export * from "./importMap.js";
 export * from "./nameTransformers.js";
 export * from "./options.js";
 export * from "./typeManifest.js";
+export * from "./wellKnownAddresses.js";

package/src/utils/wellKnownAddresses.ts

@@ -0,0 +1,64 @@
+/**
+ * Maps well-known Solana public keys to their canonical Dart constant names
+ * in `package:solana_kit_addresses`. When the renderer encounters a known
+ * address, it emits a re-export from that package instead of hardcoding the
+ * address string.
+ *
+ * The keys are the base-58 public key strings as they appear in IDL/Codama nodes.
+ * The values are the Dart constant names exported by `solana_kit_addresses`.
+ */
+export const WELL_KNOWN_ADDRESSES: ReadonlyMap<string, string> = new Map([
+  // Agave / Solana native programs
+  ['11111111111111111111111111111111', 'systemProgramAddress'],
+  ['AddressLookupTab1e1111111111111111111111111', 'addressLookupTableProgramAddress'],
+  ['BPFLoader2111111111111111111111111111111111', 'bpfLoaderProgramAddress'],
+  ['BPFLoader1111111111111111111111111111111111', 'bpfLoaderDeprecatedProgramAddress'],
+  ['BPFLoaderUpgradeab1e11111111111111111111111', 'bpfLoaderUpgradeableProgramAddress'],
+  ['ComputeBudget111111111111111111111111111111', 'computeBudgetProgramAddress'],
+  ['Config1111111111111111111111111111111111111', 'configProgramAddress'],
+  ['Ed25519SigVerify111111111111111111111111111', 'ed25519ProgramAddress'],
+  ['Feature111111111111111111111111111111111111', 'featureProgramAddress'],
+  ['1nc1nerator11111111111111111111111111111111', 'incineratorAddress'],
+  ['LoaderV411111111111111111111111111111111111', 'loaderV4ProgramAddress'],
+  ['NativeLoader1111111111111111111111111111', 'nativeLoaderProgramAddress'],
+  ['KeccakSecp256k11111111111111111111111111111', 'secp256k1ProgramAddress'],
+  ['Secp256r1SigVerify1111111111111111111111111', 'secp256r1ProgramAddress'],
+  ['Stake11111111111111111111111111111111111111', 'stakeProgramAddress'],
+  ['StakeConfig1111111111111111111111111111', 'stakeConfigAddress'],
+  ['Vote111111111111111111111111111111111111111', 'voteProgramAddress'],
+  ['ZkTokenProof1111111111111111111111111111111', 'zkTokenProofProgramAddress'],
+  ['ZkE1Gama1Proof11111111111111111111111111111', 'zkElgamalProofProgramAddress'],
+
+  // Sysvars
+  ['SysvarC1ock11111111111111111111111111111111', 'sysvarClockAddress'],
+  ['Rent11111111111111111111111111111111111111', 'sysvarRentAddress'],
+  ['11111111111111111111111111111111111111111111', 'sysvarRecentBlockhashesAddress'], // note: 44 chars
+  ['SysvarFees1111111111111111111111111111111111', 'sysvarFeesAddress'],
+  ['Sysvar1nstruct1ons11111111111111111111111111', 'sysvarInstructionsAddress'],
+  ['SysvarEpochSchedu1e111111111111111111111111', 'sysvarEpochScheduleAddress'],
+  ['SysvarRewards111111111111111111111111111111', 'sysvarRewardsAddress'],
+  ['SysvarStakeHistory1111111111111111111111111', 'sysvarStakeHistoryAddress'],
+  ['SysvarS1otHashes111111111111111111111111111', 'sysvarSlotHashesAddress'],
+  ['SysvarS1otHistory11111111111111111111111111', 'sysvarSlotHistoryAddress'],
+  ['Sysvar1111111111111111111111111111111111111', 'sysvarOwnerAddress'],
+
+  // SPL programs
+  ['TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA', 'tokenProgramAddress'],
+  ['TokenzQdBNb4qyze1S1U9AHB8MGXmNK1REkTPT5Z3Y', 'token2022ProgramAddress'],
+  ['ATokenGPvbdGVxr1b2hvZbsiqW5xWH25ef7s3c8BnQKu', 'associatedTokenProgramAddress'],
+  ['Memo1UhkJRfRhVq1sR7Y7Nto1s3J2mXTT3L6Wk4K2m6', 'memoProgramAddress'],
+  ['MemoSq4gqABXKKYWVqKkV3m3kb1cTR7F2UMy9r6kFNK', 'memoLegacyProgramAddress'],
+
+  // Metaplex programs
+  ['metaqbxxU9qX8rZXkmUJ7haCrXXz2W1PSUq1Rn3E1od', 'tokenMetadataProgramAddress'],
+  ['BGUMAp9V1mQ2KV8t34L5u3gZsXYZaYDBdKkc1xYk1qA1', 'mplBubblegumProgramAddress'],
+  ['auth9SigNpDKz4s8cHr3MFBPS1phbRKLSCN3aBe9sS', 'authRulesProgramAddress'],
+  ['CoREENxT6tW1Ho6BW6W5Z4N41ci5Xz2mmrR2kErmM5TR', 'metaplexCoreProgramAddress'],
+  ['cmtMqR4bPM9sEV3bPnJQq5s2EnYw4N5vQ8hWhEd1xzS', 'splAccountCompressionProgramAddress'],
+  ['noopb9skMVngR5Qi4sczwFr1jU4V4F7nm8xzFQK9C', 'noopProgramAddress'],
+
+  // Well-known mints
+  ['So11111111111111111111111111111111111111112', 'wrappedSolAddress'],
+  ['EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', 'usdcAddress'],
+  ['Es9vMFrzaCERm6YKXx6bqKr1Rmd9b5v3J8rM5e4rfF4', 'usdtAddress'],
+]);

package/src/visitors/getTypeManifestVisitor.ts

@@ -137,9 +137,8 @@ export function getTypeManifestVisitor(input: {
       const codecName = getNumberCodecName(format);
 
       return {
-        type: dartType === "BigInt"
-          ? use("BigInt", "dartTypedData")
-          : fragmentFromString(dartType),
+        // `BigInt` and other number types live in `dart:core` and need no import.
+        type: fragmentFromString(dartType),
         encoder: fragment`${use(
           `get${codecName}Encoder`,
           "solanaCodecsNumbers",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Ifiok Jr.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.