@cardanowall/sdk-ts 0.0.0 → 0.2.0

package/dist/verifier/index.d.cts

@@ -16,7 +16,7 @@ declare function verifyTx(input: VerifyTxInput): Promise<VerifyReport>;
  * Use this when you trust an upstream indexer for the (metadataCbor,
  * blockTime, blockSlot, numConfirmations) tuple and want to skip the
  * /tx_cbor + /tx_info round-trip. The caller is responsible for the
- * confidence that the supplied bytes actually came from a CIP-309 label-309
+ * confidence that the supplied bytes actually came from the label-309
  * metadata field of a confirmed Cardano transaction.
  */
 declare function verifyResolved(input: {
@@ -86,7 +86,7 @@ interface ResolvedTx {
 }
 declare const KOIOS_MAINNET_URL = "https://api.koios.rest/api/v1";
 declare const BLOCKFROST_MAINNET_HOST = "https://cardano-mainnet.blockfrost.io/api/v0";
-declare class NotACip309RecordError extends Error {
+declare class NotALabel309RecordError extends Error {
     readonly code: "METADATA_NOT_FOUND";
     constructor(message: string);
 }
@@ -173,4 +173,4 @@ declare function fetchItemCiphertext(args: FetchItemCiphertextArgs): Promise<Uin
 
 declare function verifyReportToDict(report: VerifyReport): Record<string, unknown>;
 
-export { BLOCKFROST_MAINNET_HOST, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_PROFILE, ExitCode, FetchOutbound, HttpCallRecord, KOIOS_MAINNET_URL, NotACip309RecordError, Profile, type ResolvedTx, type TxComponents, VerifyItemDecryption, VerifyMerkleCheck, VerifyRecordSignature, VerifyReport, VerifyTxInput, VerifyTxSummary, VerifyTxWitness, VerifyUriCheck, decodeTxSummary, decodeTxWitnesses, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx };
+export { BLOCKFROST_MAINNET_HOST, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_PROFILE, ExitCode, FetchOutbound, HttpCallRecord, KOIOS_MAINNET_URL, NotALabel309RecordError, Profile, type ResolvedTx, type TxComponents, VerifyItemDecryption, VerifyMerkleCheck, VerifyRecordSignature, VerifyReport, VerifyTxInput, VerifyTxSummary, VerifyTxWitness, VerifyUriCheck, decodeTxSummary, decodeTxWitnesses, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx };

package/dist/verifier/index.d.ts

@@ -16,7 +16,7 @@ declare function verifyTx(input: VerifyTxInput): Promise<VerifyReport>;
  * Use this when you trust an upstream indexer for the (metadataCbor,
  * blockTime, blockSlot, numConfirmations) tuple and want to skip the
  * /tx_cbor + /tx_info round-trip. The caller is responsible for the
- * confidence that the supplied bytes actually came from a CIP-309 label-309
+ * confidence that the supplied bytes actually came from the label-309
  * metadata field of a confirmed Cardano transaction.
  */
 declare function verifyResolved(input: {
@@ -86,7 +86,7 @@ interface ResolvedTx {
 }
 declare const KOIOS_MAINNET_URL = "https://api.koios.rest/api/v1";
 declare const BLOCKFROST_MAINNET_HOST = "https://cardano-mainnet.blockfrost.io/api/v0";
-declare class NotACip309RecordError extends Error {
+declare class NotALabel309RecordError extends Error {
     readonly code: "METADATA_NOT_FOUND";
     constructor(message: string);
 }
@@ -173,4 +173,4 @@ declare function fetchItemCiphertext(args: FetchItemCiphertextArgs): Promise<Uin
 
 declare function verifyReportToDict(report: VerifyReport): Record<string, unknown>;
 
-export { BLOCKFROST_MAINNET_HOST, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_PROFILE, ExitCode, FetchOutbound, HttpCallRecord, KOIOS_MAINNET_URL, NotACip309RecordError, Profile, type ResolvedTx, type TxComponents, VerifyItemDecryption, VerifyMerkleCheck, VerifyRecordSignature, VerifyReport, VerifyTxInput, VerifyTxSummary, VerifyTxWitness, VerifyUriCheck, decodeTxSummary, decodeTxWitnesses, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx };
+export { BLOCKFROST_MAINNET_HOST, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_PROFILE, ExitCode, FetchOutbound, HttpCallRecord, KOIOS_MAINNET_URL, NotALabel309RecordError, Profile, type ResolvedTx, type TxComponents, VerifyItemDecryption, VerifyMerkleCheck, VerifyRecordSignature, VerifyReport, VerifyTxInput, VerifyTxSummary, VerifyTxWitness, VerifyUriCheck, decodeTxSummary, decodeTxWitnesses, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx };

package/dist/verifier/index.js

@@ -150,7 +150,7 @@ function decodeCanonicalCbor(bytes) {
       ...cdeDecodeOptions,
       rejectStreaming: true,
       rejectDuplicateKeys: true,
-      // A CIP-309 record carries integers, byte/text strings, arrays, maps and
+      // A Label 309 record carries integers, byte/text strings, arrays, maps and
       // `null` — and nothing else. Without these rejections the major-type-7
       // surface leaks into the decoder: a float16/32/64 that happens to hold an
       // integral value (e.g. 1.0) silently decodes to the integer 1 and passes
@@ -276,7 +276,7 @@ function decodeCanonicalCbor2(bytes) {
       ...cdeDecodeOptions,
       rejectStreaming: true,
       rejectDuplicateKeys: true,
-      // A CIP-309 record carries integers, byte/text strings, arrays, maps and
+      // A Label 309 record carries integers, byte/text strings, arrays, maps and
       // `null` — and nothing else. Without these rejections the major-type-7
       // surface leaks into the decoder: a float16/32/64 that happens to hold an
       // integral value (e.g. 1.0) silently decodes to the integer 1 and passes
@@ -377,7 +377,7 @@ function buildSigStructure(args) {
     args.payload
   ]);
 }
-function buildCip309SigStructure(args) {
+function buildLabel309SigStructure(args) {
   const toSign = new Uint8Array(
     CARDANO_POE_SIG_DOMAIN_PREFIX_BYTES.length + args.recordBodyCbor.length
   );
@@ -451,7 +451,7 @@ function decodeCoseSign1(bytes) {
     signature: signatureRaw
   };
 }
-function coseSign1Cip309Verify(args) {
+function coseSign1Label309Verify(args) {
   let decoded;
   try {
     decoded = decodeCoseSign1(args.message);
@@ -518,7 +518,7 @@ function coseSign1Cip309Verify(args) {
       payload: hashedPayload
     });
   } else {
-    sigStructureBytes = buildCip309SigStructure({
+    sigStructureBytes = buildLabel309SigStructure({
       bodyProtectedBytes: decoded.protectedBytes,
       recordBodyCbor: args.detachedRecordBodyCbor
     });
@@ -878,11 +878,7 @@ function validateOneUri(chunks, path, errors) {
   const uri = reconstructed.uri;
   if (uri.includes("#")) {
     errors.push(
-      issue(
-        "INVALID_URI",
-        path,
-        "URI contains a fragment identifier ('#'), which is forbidden"
-      )
+      issue("INVALID_URI", path, "URI contains a fragment identifier ('#'), which is forbidden")
     );
     return;
   }
@@ -912,21 +908,13 @@ function validateOneUri(chunks, path, errors) {
     const cid = slashIdx === -1 ? rest : rest.slice(0, slashIdx);
     if (!validateCidProfile(cid)) {
       errors.push(
-        issue(
-          "INVALID_URI",
-          path,
-          "ipfs:// URI is not a valid CID under the CIP-309 profile"
-        )
+        issue("INVALID_URI", path, "ipfs:// URI is not a valid CID under the Label 309 profile")
       );
     }
     return;
   }
   errors.push(
-    issue(
-      "INVALID_URI",
-      path,
-      "unsupported URI scheme; v1 PoE URI set is {ar://, ipfs://}"
-    )
+    issue("INVALID_URI", path, "unsupported URI scheme; v1 PoE URI set is {ar://, ipfs://}")
   );
 }
 function checkItemEnc(item, idx, errors) {
@@ -968,7 +956,7 @@ function checkItemEnc(item, idx, errors) {
       issue(
         "UNAUTHENTICATED_CIPHER_FORBIDDEN",
         [...basePath, "aead"],
-        `'${enc.aead}' is an unauthenticated cipher; CIP-309 mandates an authenticated (AEAD) cipher`
+        `'${enc.aead}' is an unauthenticated cipher; Label 309 mandates an authenticated (AEAD) cipher`
       )
     );
     return;
@@ -3292,7 +3280,9 @@ async function tryDecryptions(args) {
     let plaintext = null;
     let failure = null;
     if (reqHasSecret) {
-      const envelope = sealedEnvelopeFromParsed(enc);
+      const envelope = sealedEnvelopeFromParsed(
+        enc
+      );
       if (envelope === null) {
         out.push({
           item_index: idx,
@@ -3411,7 +3401,7 @@ function decodeCanonicalCbor3(bytes) {
       ...cdeDecodeOptions,
       rejectStreaming: true,
       rejectDuplicateKeys: true,
-      // A CIP-309 record carries integers, byte/text strings, arrays, maps and
+      // A Label 309 record carries integers, byte/text strings, arrays, maps and
       // `null` — and nothing else. Without these rejections the major-type-7
       // surface leaks into the decoder: a float16/32/64 that happens to hold an
       // integral value (e.g. 1.0) silently decodes to the integer 1 and passes
@@ -3984,11 +3974,11 @@ function decodeIntKey(h) {
 // src/verifier/resolve.ts
 var KOIOS_MAINNET_URL = "https://api.koios.rest/api/v1";
 var BLOCKFROST_MAINNET_HOST = "https://cardano-mainnet.blockfrost.io/api/v0";
-var NotACip309RecordError = class extends Error {
+var NotALabel309RecordError = class extends Error {
   code = "METADATA_NOT_FOUND";
   constructor(message) {
     super(message);
-    this.name = "NotACip309RecordError";
+    this.name = "NotALabel309RecordError";
   }
 };
 async function resolveCardanoTx(args) {
@@ -3999,7 +3989,7 @@ async function resolveCardanoTx(args) {
     try {
       return await resolveViaKoios(input.txHash, koiosUrl, fetchFn);
     } catch (e) {
-      if (e instanceof NotACip309RecordError) throw e;
+      if (e instanceof NotALabel309RecordError) throw e;
       lastErr = e;
     }
   }
@@ -4007,7 +3997,7 @@ async function resolveCardanoTx(args) {
     try {
       return await resolveViaBlockfrost(input.txHash, input.blockfrostProjectId, fetchFn);
     } catch (e) {
-      if (e instanceof NotACip309RecordError) throw e;
+      if (e instanceof NotALabel309RecordError) throw e;
       lastErr = e;
     }
   }
@@ -4025,7 +4015,7 @@ async function resolveViaKoios(txHash, koiosUrl, fetchFn) {
   }
   const cborJson = parseJson(cborRes.bytes);
   if (!Array.isArray(cborJson) || cborJson.length === 0) {
-    throw new NotACip309RecordError("koios returned empty array for tx_cbor; tx may not exist");
+    throw new NotALabel309RecordError("koios returned empty array for tx_cbor; tx may not exist");
   }
   const cborEntry = cborJson[0];
   if (typeof cborEntry.cbor !== "string") {
@@ -4046,7 +4036,7 @@ async function resolveViaKoios(txHash, koiosUrl, fetchFn) {
   }
   const infoJson = parseJson(infoRes.bytes);
   if (!Array.isArray(infoJson) || infoJson.length === 0) {
-    throw new NotACip309RecordError("koios returned empty array for tx_info");
+    throw new NotALabel309RecordError("koios returned empty array for tx_info");
   }
   const infoEntry = infoJson[0];
   if (typeof infoEntry.tx_hash === "string" && infoEntry.tx_hash.toLowerCase() !== txHash.toLowerCase()) {
@@ -4191,7 +4181,7 @@ async function verifyOneSig(index, entry, recordBodyCbor, input) {
     return { index, verdict: "unresolved", reason: "SIGNER_KEY_UNRESOLVED" };
   }
   const { pub, signerType } = resolved;
-  const verifyResult = coseSign1Cip309Verify({
+  const verifyResult = coseSign1Label309Verify({
     message: coseBytes,
     detachedRecordBodyCbor: recordBodyCbor,
     expectedSignerKey: pub
@@ -4420,7 +4410,8 @@ function decodeTxSummary(txBodyBytes, witnessSetBytes, network) {
   else if (typeof invalidBefore === "bigint") summary.invalid_before = Number(invalidBefore);
   const invalidHereafter = body.get(BODY_KEY_INVALID_HEREAFTER);
   if (typeof invalidHereafter === "number") summary.invalid_hereafter = invalidHereafter;
-  else if (typeof invalidHereafter === "bigint") summary.invalid_hereafter = Number(invalidHereafter);
+  else if (typeof invalidHereafter === "bigint")
+    summary.invalid_hereafter = Number(invalidHereafter);
   if (requiredSigners.length > 0) summary.required_signer_key_hashes = requiredSigners;
   const networkId = body.get(BODY_KEY_NETWORK_ID);
   if (typeof networkId === "number") summary.network_id = networkId;
@@ -4539,7 +4530,7 @@ async function verifyTx(input) {
   try {
     resolved = await resolveCardanoTx({ input, fetchFn });
   } catch (e) {
-    if (e instanceof NotACip309RecordError) {
+    if (e instanceof NotALabel309RecordError) {
       return base({
         verdict: "failed",
         exit_code: 1,
@@ -4632,7 +4623,16 @@ async function verifyResolved(input) {
   return report;
 }
 async function verifyResolvedRecord(args) {
-  const { input, metadataBytes, txCbor, numConfirmations, blockTime, blockSlot, httpCalls, fetchFn } = args;
+  const {
+    input,
+    metadataBytes,
+    txCbor,
+    numConfirmations,
+    blockTime,
+    blockSlot,
+    httpCalls,
+    fetchFn
+  } = args;
   const profile = input.profile ?? DEFAULT_PROFILE;
   const threshold = input.confirmationDepthThreshold ?? CONFIRMATION_DEPTH_THRESHOLD_DEFAULT;
   const txDescription = txCbor !== void 0 ? decodeTxDescription(txCbor, input) : {};
@@ -4843,6 +4843,6 @@ function verifyReportToDict(report) {
   (*! noble-post-quantum - MIT License (c) 2024 Paul Miller (paulmillr.com) *)
 */
 
-export { BLOCKFROST_MAINNET_HOST, BodyTooLargeError, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_OUTBOUND_MAX_BYTES, DEFAULT_PROFILE, DENY_HOSTS_DEFAULT, DenyHostError, KOIOS_MAINNET_URL, NotACip309RecordError, OutboundExhaustedError, PROFILE_RANK, UnsupportedMethodError, UnsupportedProtocolError, decodeTxSummary, decodeTxWitnesses, defaultFetchOutbound, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, fetchOutbound, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx, wrapFetchOutbound };
+export { BLOCKFROST_MAINNET_HOST, BodyTooLargeError, CONFIRMATION_DEPTH_THRESHOLD_DEFAULT, DEFAULT_OUTBOUND_MAX_BYTES, DEFAULT_PROFILE, DENY_HOSTS_DEFAULT, DenyHostError, KOIOS_MAINNET_URL, NotALabel309RecordError, OutboundExhaustedError, PROFILE_RANK, UnsupportedMethodError, UnsupportedProtocolError, decodeTxSummary, decodeTxWitnesses, defaultFetchOutbound, exitCodeForVerdict, extractLabel309Metadata, fetchItemCiphertext, fetchOutbound, planProfileSkips, profileImplements, resolveCardanoTx, sliceLabel309Value, sliceTxComponents, tryDecryptions, verifyMerkleCommitments, verifyRecordSignatures, verifyReportToDict, verifyResolved, verifyTx, wrapFetchOutbound };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map