@xyo-network/xl1-protocol-sdk 1.4.8 → 1.5.0

package/dist/neutral/index.mjs

@@ -94,13 +94,13 @@ var hydrateElevatedTransaction = /* @__PURE__ */ __name(async (archivist, hash)
 }, "hydrateElevatedTransaction");
 
 // src/transaction/transactionRequiredGas.ts
-import { TransactionGasCosts } from "@xyo-network/xl1-protocol";
+import { AttoXL1, TransactionGasCosts } from "@xyo-network/xl1-protocol";
 function transactionRequiredGas([transaction, payloads]) {
   const characters = payloads.reduce((acc, payload) => acc + JSON.stringify(payload).length, 0);
   const hashes = transaction.payload_hashes.length + 1;
   const signatures = transaction.addresses.length + 1;
   const elevatedPayloads = (transaction.script ?? []).length;
-  return TransactionGasCosts.characterStorage * BigInt(characters) + TransactionGasCosts.hashValidation * BigInt(hashes) + TransactionGasCosts.signatureValidation * BigInt(signatures) + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads);
+  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters) + TransactionGasCosts.hashValidation * BigInt(hashes) + TransactionGasCosts.signatureValidation * BigInt(signatures) + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads));
 }
 __name(transactionRequiredGas, "transactionRequiredGas");
 export {

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transaction/buildTransaction.ts","../../src/transaction/hydrateTransaction.ts","../../src/transaction/transactionRequiredGas.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type { Address } from '@xylabs/hex'\nimport { toHex } from '@xylabs/hex'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type { Payload } from '@xyo-network/payload-model'\nimport {\n  type AllowedBlockPayload,\n  defaultTransactionFees,\n  type HydratedTransactionWithStorageMeta, type TransactionBoundWitness, type TransactionBoundWitnessFields, type TransactionFeesBigInt,\n} from '@xyo-network/xl1-protocol'\n\nexport async function buildTransaction(\n  chain: Address,\n  elevatedPayloads: AllowedBlockPayload[],\n  additionalPayloads: Payload[],\n  signer: AccountInstance | AccountInstance[],\n  nbf: number,\n  exp: number,\n  from?: Address,\n  fees: TransactionFeesBigInt = defaultTransactionFees,\n): Promise<HydratedTransactionWithStorageMeta> {\n  if (from === undefined && Array.isArray(signer)) {\n    throw new Error('from is required when signer is an array')\n  }\n\n  const txBoundWitnessFields: TransactionBoundWitnessFields = {\n    chain,\n    fees: {\n      base: toHex(fees.base),\n      gasLimit: toHex(fees.gasLimit),\n      gasPrice: toHex(fees.gasPrice),\n      priority: toHex(fees.priority),\n    },\n    nbf,\n    exp,\n  }\n\n  const elevatedHashes = await PayloadBuilder.hashes(elevatedPayloads)\n  const script: string[] = []\n  for (const elevatedHash of elevatedHashes) {\n    script.push(`elevate|${elevatedHash}`)\n  }\n\n  const [tx, txPayloads] = await new BoundWitnessBuilder<TransactionBoundWitness>()\n    .fields({\n      ...txBoundWitnessFields,\n      script,\n      from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address),\n    })\n    .meta({ $signatures: [] })\n    .payloads([...elevatedPayloads, ...additionalPayloads])\n    .signers(Array.isArray(signer) ? signer : [signer])\n    .build()\n\n  return [await PayloadBuilder.addStorageMeta(tx), await PayloadBuilder.addStorageMeta(txPayloads)]\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport type { ReadArchivist } from '@xyo-network/archivist-model'\nimport { hydrateTypedBoundWitness, tryHydrateTypedBoundWitness } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\nimport type {\n  AllowedBlockPayload,\n  HydratedTransaction, HydratedTransactionWithStorageMeta, TransactionBoundWitness,\n} from '@xyo-network/xl1-protocol'\nimport { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'\n\nexport const tryHydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta | undefined> => {\n  return (await tryHydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  )) as HydratedTransactionWithStorageMeta | undefined\n}\n\nexport const hydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta> => {\n  return await hydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  ) as HydratedTransactionWithStorageMeta\n}\n\nexport const flattenHydratedTransaction = (hydratedTransaction: HydratedTransaction): Payload[] => {\n  const [tx, txPayloads] = hydratedTransaction\n  return [...txPayloads, tx]\n}\n\nexport const flattenHydratedTransactions = (hydratedTransactions: HydratedTransaction[]): Payload[] =>\n  hydratedTransactions.flatMap(tx => flattenHydratedTransaction(tx))\n\nexport const tryHydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction | undefined> => {\n  const hydratedTransaction = await tryHydrateTransaction(archivist, hash)\n  if (!hydratedTransaction) {\n    return undefined\n  }\n  const [transaction, payloads] = hydratedTransaction\n  const opCodes = (transaction.script ?? []).filter(operation => operation.startsWith('elevate|'))\n  const elevatedPayloads: AllowedBlockPayload[] = []\n  for (const opCode of opCodes) {\n    const [code, hash] = opCode.split('|')\n    if (code === 'elevated') {\n      const elevatedPayload = payloads.find(payload => payload._hash === hash)\n      if (isAllowedBlockPayload(elevatedPayload)) {\n        elevatedPayloads.push(elevatedPayload)\n      }\n    }\n  }\n  if (opCodes.length === elevatedPayloads.length) {\n    return [transaction, elevatedPayloads]\n  }\n  return undefined\n}\n\nexport const hydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction> => {\n  return assertEx(await tryHydrateElevatedTransaction(archivist, hash), () => 'Hydration failed')\n}\n","import type { HydratedTransaction } from '@xyo-network/xl1-protocol'\nimport { TransactionGasCosts } from '@xyo-network/xl1-protocol'\n\nexport function transactionRequiredGas([transaction, payloads]: HydratedTransaction): bigint {\n  const characters = payloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0)\n  const hashes = transaction.payload_hashes.length + 1 /* for transaction itself */\n  const signatures = transaction.addresses.length + 1\n  const elevatedPayloads = (transaction.script ?? []).length\n  return TransactionGasCosts.characterStorage * BigInt(characters)\n    + TransactionGasCosts.hashValidation * BigInt(hashes)\n    + TransactionGasCosts.signatureValidation * BigInt(signatures)\n    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads)\n}\n"],"mappings":"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","names":["assertEx","toHex","BoundWitnessBuilder","PayloadBuilder","defaultTransactionFees","buildTransaction","chain","elevatedPayloads","additionalPayloads","signer","nbf","exp","from","fees","defaultTransactionFees","undefined","Array","isArray","Error","txBoundWitnessFields","base","toHex","gasLimit","gasPrice","priority","elevatedHashes","PayloadBuilder","hashes","script","elevatedHash","push","tx","txPayloads","BoundWitnessBuilder","fields","assertEx","at","address","meta","$signatures","payloads","signers","build","addStorageMeta","assertEx","hydrateTypedBoundWitness","tryHydrateTypedBoundWitness","isAllowedBlockPayload","isTransactionBoundWitnessWithStorageMeta","tryHydrateTransaction","archivist","hash","tryHydrateTypedBoundWitness","isTransactionBoundWitnessWithStorageMeta","hydrateTransaction","hydrateTypedBoundWitness","flattenHydratedTransaction","hydratedTransaction","tx","txPayloads","flattenHydratedTransactions","hydratedTransactions","flatMap","tryHydrateElevatedTransaction","undefined","transaction","payloads","opCodes","script","filter","operation","startsWith","elevatedPayloads","opCode","code","split","elevatedPayload","find","payload","_hash","isAllowedBlockPayload","push","length","hydrateElevatedTransaction","assertEx","TransactionGasCosts","transactionRequiredGas","transaction","payloads","characters","reduce","acc","payload","JSON","stringify","length","hashes","payload_hashes","signatures","addresses","elevatedPayloads","script","TransactionGasCosts","characterStorage","BigInt","hashValidation","signatureValidation","payloadValidation"]}
+{"version":3,"sources":["../../src/transaction/buildTransaction.ts","../../src/transaction/hydrateTransaction.ts","../../src/transaction/transactionRequiredGas.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type { Address } from '@xylabs/hex'\nimport { toHex } from '@xylabs/hex'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type { Payload } from '@xyo-network/payload-model'\nimport {\n  type AllowedBlockPayload,\n  defaultTransactionFees,\n  type HydratedTransactionWithStorageMeta, type TransactionBoundWitness, type TransactionBoundWitnessFields, type TransactionFeesBigInt,\n} from '@xyo-network/xl1-protocol'\n\nexport async function buildTransaction(\n  chain: Address,\n  elevatedPayloads: AllowedBlockPayload[],\n  additionalPayloads: Payload[],\n  signer: AccountInstance | AccountInstance[],\n  nbf: number,\n  exp: number,\n  from?: Address,\n  fees: TransactionFeesBigInt = defaultTransactionFees,\n): Promise<HydratedTransactionWithStorageMeta> {\n  if (from === undefined && Array.isArray(signer)) {\n    throw new Error('from is required when signer is an array')\n  }\n\n  const txBoundWitnessFields: TransactionBoundWitnessFields = {\n    chain,\n    fees: {\n      base: toHex(fees.base),\n      gasLimit: toHex(fees.gasLimit),\n      gasPrice: toHex(fees.gasPrice),\n      priority: toHex(fees.priority),\n    },\n    nbf,\n    exp,\n  }\n\n  const elevatedHashes = await PayloadBuilder.hashes(elevatedPayloads)\n  const script: string[] = []\n  for (const elevatedHash of elevatedHashes) {\n    script.push(`elevate|${elevatedHash}`)\n  }\n\n  const [tx, txPayloads] = await new BoundWitnessBuilder<TransactionBoundWitness>()\n    .fields({\n      ...txBoundWitnessFields,\n      script,\n      from: from ?? (Array.isArray(signer) ? assertEx(signer.at(0)?.address) : signer.address),\n    })\n    .meta({ $signatures: [] })\n    .payloads([...elevatedPayloads, ...additionalPayloads])\n    .signers(Array.isArray(signer) ? signer : [signer])\n    .build()\n\n  return [await PayloadBuilder.addStorageMeta(tx), await PayloadBuilder.addStorageMeta(txPayloads)]\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport type { ReadArchivist } from '@xyo-network/archivist-model'\nimport { hydrateTypedBoundWitness, tryHydrateTypedBoundWitness } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\nimport type {\n  AllowedBlockPayload,\n  HydratedTransaction, HydratedTransactionWithStorageMeta, TransactionBoundWitness,\n} from '@xyo-network/xl1-protocol'\nimport { isAllowedBlockPayload, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'\n\nexport const tryHydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta | undefined> => {\n  return (await tryHydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  )) as HydratedTransactionWithStorageMeta | undefined\n}\n\nexport const hydrateTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransactionWithStorageMeta> => {\n  return await hydrateTypedBoundWitness<TransactionBoundWitness>(\n    archivist,\n    hash,\n    isTransactionBoundWitnessWithStorageMeta,\n  ) as HydratedTransactionWithStorageMeta\n}\n\nexport const flattenHydratedTransaction = (hydratedTransaction: HydratedTransaction): Payload[] => {\n  const [tx, txPayloads] = hydratedTransaction\n  return [...txPayloads, tx]\n}\n\nexport const flattenHydratedTransactions = (hydratedTransactions: HydratedTransaction[]): Payload[] =>\n  hydratedTransactions.flatMap(tx => flattenHydratedTransaction(tx))\n\nexport const tryHydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction | undefined> => {\n  const hydratedTransaction = await tryHydrateTransaction(archivist, hash)\n  if (!hydratedTransaction) {\n    return undefined\n  }\n  const [transaction, payloads] = hydratedTransaction\n  const opCodes = (transaction.script ?? []).filter(operation => operation.startsWith('elevate|'))\n  const elevatedPayloads: AllowedBlockPayload[] = []\n  for (const opCode of opCodes) {\n    const [code, hash] = opCode.split('|')\n    if (code === 'elevated') {\n      const elevatedPayload = payloads.find(payload => payload._hash === hash)\n      if (isAllowedBlockPayload(elevatedPayload)) {\n        elevatedPayloads.push(elevatedPayload)\n      }\n    }\n  }\n  if (opCodes.length === elevatedPayloads.length) {\n    return [transaction, elevatedPayloads]\n  }\n  return undefined\n}\n\nexport const hydrateElevatedTransaction = async (\n  archivist: ReadArchivist,\n  hash: Hash,\n): Promise<HydratedTransaction> => {\n  return assertEx(await tryHydrateElevatedTransaction(archivist, hash), () => 'Hydration failed')\n}\n","import type { HydratedTransaction } from '@xyo-network/xl1-protocol'\nimport { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'\n\nexport function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {\n  const characters = payloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0)\n  const hashes = transaction.payload_hashes.length + 1 /* for transaction itself */\n  const signatures = transaction.addresses.length + 1\n  const elevatedPayloads = (transaction.script ?? []).length\n  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters)\n    + TransactionGasCosts.hashValidation * BigInt(hashes)\n    + TransactionGasCosts.signatureValidation * BigInt(signatures)\n    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads))\n}\n"],"mappings":"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","names":["assertEx","toHex","BoundWitnessBuilder","PayloadBuilder","defaultTransactionFees","buildTransaction","chain","elevatedPayloads","additionalPayloads","signer","nbf","exp","from","fees","defaultTransactionFees","undefined","Array","isArray","Error","txBoundWitnessFields","base","toHex","gasLimit","gasPrice","priority","elevatedHashes","PayloadBuilder","hashes","script","elevatedHash","push","tx","txPayloads","BoundWitnessBuilder","fields","assertEx","at","address","meta","$signatures","payloads","signers","build","addStorageMeta","assertEx","hydrateTypedBoundWitness","tryHydrateTypedBoundWitness","isAllowedBlockPayload","isTransactionBoundWitnessWithStorageMeta","tryHydrateTransaction","archivist","hash","tryHydrateTypedBoundWitness","isTransactionBoundWitnessWithStorageMeta","hydrateTransaction","hydrateTypedBoundWitness","flattenHydratedTransaction","hydratedTransaction","tx","txPayloads","flattenHydratedTransactions","hydratedTransactions","flatMap","tryHydrateElevatedTransaction","undefined","transaction","payloads","opCodes","script","filter","operation","startsWith","elevatedPayloads","opCode","code","split","elevatedPayload","find","payload","_hash","isAllowedBlockPayload","push","length","hydrateElevatedTransaction","assertEx","AttoXL1","TransactionGasCosts","transactionRequiredGas","transaction","payloads","characters","reduce","acc","payload","JSON","stringify","length","hashes","payload_hashes","signatures","addresses","elevatedPayloads","script","AttoXL1","TransactionGasCosts","characterStorage","BigInt","hashValidation","signatureValidation","payloadValidation"]}

package/dist/types/instances/Address.d.ts

@@ -1,11 +1,13 @@
 import type { Address } from '@xylabs/hex';
 import type { Promisable } from '@xylabs/promise';
+import type { BlockWindowInstance } from './modifiers/BlockWindowInstance.ts';
 import type { BlockWindowStateInstance } from './modifiers/BlockWindowState.ts';
 import type { ValidatableInstance } from './modifiers/Validatable.ts';
+import type { XL1AmountInstance } from './XL1Amount.ts';
 export interface AddressInstance extends ValidatableInstance {
     address: Address;
 }
 export interface AddressStateInstance extends AddressInstance, BlockWindowStateInstance {
-    balance(): Promisable<bigint>;
+    balance(): Promisable<[XL1AmountInstance, BlockWindowInstance]>;
 }
 //# sourceMappingURL=Address.d.ts.map

package/dist/types/instances/Address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../../src/instances/Address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe,EAAE,wBAAwB;IACrF,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;CAC9B"}
+{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../../src/instances/Address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe,EAAE,wBAAwB;IACrF,OAAO,IAAI,UAAU,CAAC,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAA;CAChE"}

package/dist/types/instances/ShiftedBigIntConfig.d.ts

@@ -0,0 +1,8 @@
+export interface ShiftedBigIntConfig {
+    locale: Intl.LocalesArgument;
+    maxCharacters: number;
+    maxDecimal: number;
+    minDecimals: number;
+    places: number;
+}
+//# sourceMappingURL=ShiftedBigIntConfig.d.ts.map

package/dist/types/instances/ShiftedBigIntConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShiftedBigIntConfig.d.ts","sourceRoot":"","sources":["../../../src/instances/ShiftedBigIntConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAA;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/types/instances/XL1Amount.d.ts

@@ -0,0 +1,14 @@
+import type { AttoXL1, FemtoXL1, MicroXL1, MilliXL1, NanoXL1, PicoXL1 } from '@xyo-network/xl1-protocol';
+import { type ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts';
+export interface XL1AmountInstance {
+    value: AttoXL1;
+    to(places: bigint | number): bigint;
+    milli: MilliXL1;
+    micro: MicroXL1;
+    nano: NanoXL1;
+    pico: PicoXL1;
+    femto: FemtoXL1;
+    atto: AttoXL1;
+    toString(places: number, config: Partial<ShiftedBigIntConfig>): string;
+}
+//# sourceMappingURL=XL1Amount.d.ts.map

package/dist/types/instances/XL1Amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XL1Amount.d.ts","sourceRoot":"","sources":["../../../src/instances/XL1Amount.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EACxD,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAA;IAEd,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAEnC,KAAK,EAAE,QAAQ,CAAA;IAEf,KAAK,EAAE,QAAQ,CAAA;IAEf,IAAI,EAAE,OAAO,CAAA;IAEb,IAAI,EAAE,OAAO,CAAA;IAEb,KAAK,EAAE,QAAQ,CAAA;IAEf,IAAI,EAAE,OAAO,CAAA;IAEb,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAA;CACvE"}

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

@@ -6,6 +6,8 @@ export * from './Fees.ts';
 export * from './modifiers/index.ts';
 export * from './Object.ts';
 export * from './Payload.ts';
+export * from './ShiftedBigIntConfig.ts';
 export * from './Signature.ts';
 export * from './transaction/index.ts';
+export * from './XL1Amount.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instances/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instances/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}

package/dist/types/transaction/transactionRequiredGas.d.ts

@@ -1,3 +1,4 @@
 import type { HydratedTransaction } from '@xyo-network/xl1-protocol';
-export declare function transactionRequiredGas([transaction, payloads]: HydratedTransaction): bigint;
+import { AttoXL1 } from '@xyo-network/xl1-protocol';
+export declare function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1;
 //# sourceMappingURL=transactionRequiredGas.d.ts.map

package/dist/types/transaction/transactionRequiredGas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactionRequiredGas.d.ts","sourceRoot":"","sources":["../../../src/transaction/transactionRequiredGas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAGpE,wBAAgB,sBAAsB,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAS3F"}
+{"version":3,"file":"transactionRequiredGas.d.ts","sourceRoot":"","sources":["../../../src/transaction/transactionRequiredGas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAA;AAExE,wBAAgB,sBAAsB,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAS5F"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.4.8",
+  "version": "1.5.0",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -34,23 +34,23 @@
     "deploy3": "echo Deploy3 not allowed!"
   },
   "dependencies": {
-    "@xylabs/assert": "^4.10.1",
-    "@xylabs/hex": "^4.10.1",
-    "@xylabs/object": "^4.10.1",
-    "@xylabs/promise": "^4.10.1",
-    "@xyo-network/account-model": "^3.17.0",
-    "@xyo-network/archivist-model": "^3.17.0",
-    "@xyo-network/boundwitness-builder": "^3.17.0",
-    "@xyo-network/boundwitness-model": "^3.17.0",
-    "@xyo-network/payload-builder": "^3.17.0",
-    "@xyo-network/payload-model": "^3.17.0",
-    "@xyo-network/xl1-protocol": "^1.4.0"
+    "@xylabs/assert": "^4.11.3",
+    "@xylabs/hex": "^4.11.3",
+    "@xylabs/object": "^4.11.3",
+    "@xylabs/promise": "^4.11.3",
+    "@xyo-network/account-model": "^3.17.1",
+    "@xyo-network/archivist-model": "^3.17.1",
+    "@xyo-network/boundwitness-builder": "^3.17.1",
+    "@xyo-network/boundwitness-model": "^3.17.1",
+    "@xyo-network/payload-builder": "^3.17.1",
+    "@xyo-network/payload-model": "^3.17.1",
+    "@xyo-network/xl1-protocol": "^1.4.9"
   },
   "devDependencies": {
-    "@types/node": "^22.15.21",
+    "@types/node": "^22.15.24",
     "@xylabs/ts-scripts-yarn3": "^6.5.7",
     "@xylabs/tsconfig": "^6.5.7",
-    "knip": "^5.57.2",
+    "knip": "^5.59.1",
     "typescript": "^5.8.3"
   },
   "engines": {

package/src/instances/Address.ts

@@ -1,13 +1,15 @@
 import type { Address } from '@xylabs/hex'
 import type { Promisable } from '@xylabs/promise'
 
+import type { BlockWindowInstance } from './modifiers/BlockWindowInstance.ts'
 import type { BlockWindowStateInstance } from './modifiers/BlockWindowState.ts'
 import type { ValidatableInstance } from './modifiers/Validatable.ts'
+import type { XL1AmountInstance } from './XL1Amount.ts'
 
 export interface AddressInstance extends ValidatableInstance {
   address: Address
 }
 
 export interface AddressStateInstance extends AddressInstance, BlockWindowStateInstance {
-  balance(): Promisable<bigint>
+  balance(): Promisable<[XL1AmountInstance, BlockWindowInstance]>
 }

package/src/instances/ShiftedBigIntConfig.ts

@@ -0,0 +1,7 @@
+export interface ShiftedBigIntConfig {
+  locale: Intl.LocalesArgument
+  maxCharacters: number
+  maxDecimal: number
+  minDecimals: number
+  places: number
+}

package/src/instances/XL1Amount.ts

@@ -0,0 +1,27 @@
+/* eslint-disable @typescript-eslint/member-ordering */
+
+import type {
+  AttoXL1, FemtoXL1, MicroXL1, MilliXL1, NanoXL1, PicoXL1,
+} from '@xyo-network/xl1-protocol'
+
+import { type ShiftedBigIntConfig } from './ShiftedBigIntConfig.ts'
+
+export interface XL1AmountInstance {
+  value: AttoXL1
+
+  to(places: bigint | number): bigint
+
+  milli: MilliXL1
+
+  micro: MicroXL1
+
+  nano: NanoXL1
+
+  pico: PicoXL1
+
+  femto: FemtoXL1
+
+  atto: AttoXL1
+
+  toString(places: number, config: Partial<ShiftedBigIntConfig>): string
+}

package/src/instances/index.ts

@@ -6,5 +6,7 @@ export * from './Fees.ts'
 export * from './modifiers/index.ts'
 export * from './Object.ts'
 export * from './Payload.ts'
+export * from './ShiftedBigIntConfig.ts'
 export * from './Signature.ts'
 export * from './transaction/index.ts'
+export * from './XL1Amount.ts'

package/src/transaction/transactionRequiredGas.ts

@@ -1,13 +1,13 @@
 import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
-import { TransactionGasCosts } from '@xyo-network/xl1-protocol'
+import { AttoXL1, TransactionGasCosts } from '@xyo-network/xl1-protocol'
 
-export function transactionRequiredGas([transaction, payloads]: HydratedTransaction): bigint {
+export function transactionRequiredGas([transaction, payloads]: HydratedTransaction): AttoXL1 {
   const characters = payloads.reduce((acc: number, payload) => acc + JSON.stringify(payload).length, 0)
   const hashes = transaction.payload_hashes.length + 1 /* for transaction itself */
   const signatures = transaction.addresses.length + 1
   const elevatedPayloads = (transaction.script ?? []).length
-  return TransactionGasCosts.characterStorage * BigInt(characters)
+  return AttoXL1(TransactionGasCosts.characterStorage * BigInt(characters)
     + TransactionGasCosts.hashValidation * BigInt(hashes)
     + TransactionGasCosts.signatureValidation * BigInt(signatures)
-    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads)
+    + TransactionGasCosts.payloadValidation * BigInt(elevatedPayloads))
 }