Merge pull request #90 from IntersectMBO/feat/uplc-decoder

feat: add uplc decoder

Author: solidsnakedev

docs/app/tools/uplc-decoder/page.tsx

@@ -0,0 +1,21 @@
+import { UplcDecoder } from "./uplc-decoder"
+import type { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'UPLC Decoder | Evolution SDK',
+  description: 'Decode UPLC (Untyped Plutus Core) programs from CBOR hex format',
+}
+
+export default function UplcDecoderPage() {
+  return (
+    <div className="container mx-auto px-4 py-8 max-w-6xl">
+      <div className="mb-8">
+        <h1 className="text-4xl font-bold mb-4">UPLC Decoder</h1>
+        <p className="text-muted-foreground text-lg">
+          Decode UPLC (Untyped Plutus Core) programs from CBOR hex format. Automatically handles single or double CBOR encoding.
+        </p>
+      </div>
+      <UplcDecoder />
+    </div>
+  )
+}

docs/app/tools/uplc-decoder/uplc-decoder.tsx

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./out/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

docs/next-env.d.ts

@@ -25,6 +25,7 @@
     "next-themes": "^0.4.6",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
+    "react18-json-view": "^0.2.9",
     "twoslash": "^0.3.4"
   },
   "devDependencies": {

docs/package.json

@@ -161,6 +161,29 @@ export const STRUCT_FRIENDLY_OPTIONS: CodecOptions = {
   mapsAsObjects: true
 } as const
 
+/**
+ * Cardano Node compatible CBOR encoding options for PlutusData
+ *
+ * Uses definite-length encoding for arrays and maps, matching the format
+ * produced by CML's `to_cardano_node_format().to_cbor_hex()`.
+ *
+ * Note: The on-chain format uses indefinite-length (AIKEN_DEFAULT_OPTIONS),
+ * but this option is useful for testing compatibility with tools that
+ * expect definite-length encoding.
+ *
+ * @since 2.0.0
+ * @category constants
+ */
+export const CARDANO_NODE_DATA_OPTIONS: CodecOptions = {
+  mode: "custom",
+  useIndefiniteArrays: false,
+  useIndefiniteMaps: false,
+  useDefiniteForEmpty: true,
+  sortMapKeys: false,
+  useMinimalEncoding: true,
+  mapsAsObjects: false
+} as const
+
 const DEFAULT_OPTIONS: CodecOptions = {
   mode: "custom",
   useIndefiniteArrays: false,

packages/evolution/src/core/CBOR.ts

@@ -106,6 +106,7 @@ export * as TransactionOutput from "./TransactionOutput.js"
 export * as TransactionWitnessSet from "./TransactionWitnessSet.js"
 export * as TSchema from "./TSchema.js"
 export * as UnitInterval from "./UnitInterval.js"
+export * as UPLC from "./uplc/index.js"
 export * as Url from "./Url.js"
 export * as Value from "./Value.js"
 export * as VKey from "./VKey.js"