opnet 1.0.0 → 1.0.2

package/.idea/OPNet.iml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/build" />
+      <excludeFolder url="file://$MODULE_DIR$/packages" />
+      <excludeFolder url="file://$MODULE_DIR$/cjs" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/bsc.iml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/build" />
+      <excludeFolder url="file://$MODULE_DIR$/cjs" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/codeStyles/Project.xml

@@ -0,0 +1,101 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <HTMLCodeStyleSettings>
+      <option name="HTML_SPACE_INSIDE_EMPTY_TAG" value="true" />
+      <option name="HTML_QUOTE_STYLE" value="Single" />
+      <option name="HTML_ENFORCE_QUOTES" value="true" />
+    </HTMLCodeStyleSettings>
+    <JSCodeStyleSettings version="0">
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="WhenMultiline" />
+      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
+      <option name="SPACES_WITHIN_IMPORTS" value="true" />
+      <option name="IMPORT_SORT_MODULE_NAME" value="true" />
+    </JSCodeStyleSettings>
+    <Markdown>
+      <option name="KEEP_LINE_BREAKS_INSIDE_TEXT_BLOCKS" value="false" />
+    </Markdown>
+    <TypeScriptCodeStyleSettings version="0">
+      <option name="FORCE_SEMICOLON_STYLE" value="true" />
+      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
+      <option name="USE_DOUBLE_QUOTES" value="false" />
+      <option name="FORCE_QUOTE_STYlE" value="true" />
+      <option name="ENFORCE_TRAILING_COMMA" value="WhenMultiline" />
+      <option name="USE_EXPLICIT_JS_EXTENSION" value="TRUE" />
+      <option name="VAR_DECLARATION_WRAP" value="5" />
+      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
+      <option name="SPACES_WITHIN_IMPORTS" value="true" />
+      <option name="IMPORT_SORT_MODULE_NAME" value="true" />
+    </TypeScriptCodeStyleSettings>
+    <VueCodeStyleSettings>
+      <option name="INTERPOLATION_NEW_LINE_AFTER_START_DELIMITER" value="false" />
+      <option name="INTERPOLATION_NEW_LINE_BEFORE_END_DELIMITER" value="false" />
+    </VueCodeStyleSettings>
+    <codeStyleSettings language="HTML">
+      <option name="SOFT_MARGINS" value="100" />
+      <indentOptions>
+        <option name="CONTINUATION_INDENT_SIZE" value="4" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="JSON">
+      <indentOptions>
+        <option name="INDENT_SIZE" value="4" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="JavaScript">
+      <option name="ALIGN_MULTILINE_PARAMETERS_IN_CALLS" value="true" />
+      <option name="ALIGN_MULTILINE_BINARY_OPERATION" value="true" />
+      <option name="CALL_PARAMETERS_WRAP" value="5" />
+      <option name="PREFER_PARAMETERS_WRAP" value="true" />
+      <option name="CALL_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
+      <option name="CALL_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
+      <option name="METHOD_PARAMETERS_WRAP" value="5" />
+      <option name="METHOD_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
+      <option name="METHOD_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
+      <option name="BINARY_OPERATION_WRAP" value="5" />
+      <option name="SOFT_MARGINS" value="100" />
+    </codeStyleSettings>
+    <codeStyleSettings language="Markdown">
+      <option name="RIGHT_MARGIN" value="80" />
+      <option name="WRAP_ON_TYPING" value="1" />
+      <option name="SOFT_MARGINS" value="80" />
+      <indentOptions>
+        <option name="INDENT_SIZE" value="2" />
+        <option name="CONTINUATION_INDENT_SIZE" value="4" />
+        <option name="TAB_SIZE" value="2" />
+      </indentOptions>
+    </codeStyleSettings>
+    <codeStyleSettings language="TypeScript">
+      <option name="ALIGN_MULTILINE_CHAINED_METHODS" value="true" />
+      <option name="ALIGN_MULTILINE_PARAMETERS_IN_CALLS" value="true" />
+      <option name="ALIGN_MULTILINE_BINARY_OPERATION" value="true" />
+      <option name="ALIGN_MULTILINE_ARRAY_INITIALIZER_EXPRESSION" value="true" />
+      <option name="CALL_PARAMETERS_WRAP" value="5" />
+      <option name="PREFER_PARAMETERS_WRAP" value="true" />
+      <option name="CALL_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
+      <option name="CALL_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
+      <option name="METHOD_PARAMETERS_WRAP" value="5" />
+      <option name="METHOD_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
+      <option name="METHOD_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
+      <option name="METHOD_CALL_CHAIN_WRAP" value="5" />
+      <option name="PARENTHESES_EXPRESSION_LPAREN_WRAP" value="true" />
+      <option name="PARENTHESES_EXPRESSION_RPAREN_WRAP" value="true" />
+      <option name="FOR_STATEMENT_LPAREN_ON_NEXT_LINE" value="true" />
+      <option name="FOR_STATEMENT_RPAREN_ON_NEXT_LINE" value="true" />
+      <option name="ARRAY_INITIALIZER_WRAP" value="5" />
+      <option name="ARRAY_INITIALIZER_LBRACE_ON_NEXT_LINE" value="true" />
+      <option name="ARRAY_INITIALIZER_RBRACE_ON_NEXT_LINE" value="true" />
+      <option name="SOFT_MARGINS" value="100" />
+    </codeStyleSettings>
+    <codeStyleSettings language="Vue">
+      <option name="SOFT_MARGINS" value="100" />
+      <indentOptions>
+        <option name="INDENT_SIZE" value="4" />
+        <option name="TAB_SIZE" value="4" />
+      </indentOptions>
+    </codeStyleSettings>
+  </code_scheme>
+</component>

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
+  </state>
+</component>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,7 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="TsLint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/markdown.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MarkdownSettings">
+    <option name="areInjectionsEnabled" value="false" />
+    <option name="showProblemsInCodeBlocks" value="false" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -2,7 +2,7 @@
 <project version="4">
   <component name="ProjectModuleManager">
     <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/opnet.iml" filepath="$PROJECT_DIR$/.idea/opnet.iml" />
+      <module fileurl="file://$PROJECT_DIR$/.idea/OPNet.iml" filepath="$PROJECT_DIR$/.idea/OPNet.iml" />
     </modules>
   </component>
 </project>

package/.idea/motoswap.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -46,14 +46,13 @@ npm i opnet
 
 ## Usage
 
-Refer to the `docs/` directory for detailed guides on how to use the BSI Transaction Builder. Start
+Refer to the `docs/` directory for detailed guides on how to use OPNet. Start
 with `getting_started.md` and explore `api_reference.md` for comprehensive information about the functions available.
 
 ## Contribution
 
 Contributions are welcome! Please read through the `CONTRIBUTING.md` file for guidelines on how to submit issues,
-feature requests, and pull requests. We appreciate your input and encourage you to help us improve the BSI Transaction
-Builder.
+feature requests, and pull requests. We appreciate your input and encourage you to help us improve OPNet.
 
 ## License
 

package/build/block/Block.d.ts

@@ -0,0 +1,27 @@
+import { BigNumberish } from 'ethers';
+import { BlockHeaderChecksumProof, IBlock } from '../interfaces/blocks/IBlock.js';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { TransactionBase } from '../transactions/Transaction.js';
+export declare class Block implements IBlock {
+    readonly height: BigNumberish;
+    readonly hash: string;
+    readonly previousBlockHash: string;
+    readonly previousBlockChecksum: string;
+    readonly bits: string;
+    readonly nonce: number;
+    readonly version: number;
+    readonly size: number;
+    readonly txCount: number;
+    readonly weight: number;
+    readonly strippedSize: number;
+    readonly time: number;
+    readonly medianTime: number;
+    readonly checksumRoot: string;
+    readonly merkleRoot: string;
+    readonly storageRoot: string;
+    readonly receiptRoot: string;
+    readonly checksumProofs: BlockHeaderChecksumProof;
+    readonly transactions?: TransactionBase<OPNetTransactionTypes>[];
+    constructor(block: IBlock);
+    private getTransactions;
+}

package/build/block/Block.js

@@ -0,0 +1,68 @@
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { DeploymentTransaction } from '../transactions/DeploymentTransaction.js';
+import { GenericTransaction } from '../transactions/GenericTransaction.js';
+import { InteractionTransaction } from '../transactions/InteractionTransaction.js';
+export class Block {
+    height;
+    hash;
+    previousBlockHash;
+    previousBlockChecksum;
+    bits;
+    nonce;
+    version;
+    size;
+    txCount;
+    weight;
+    strippedSize;
+    time;
+    medianTime;
+    checksumRoot;
+    merkleRoot;
+    storageRoot;
+    receiptRoot;
+    checksumProofs;
+    transactions;
+    constructor(block) {
+        this.height = BigInt(block.height.toString());
+        this.hash = block.hash;
+        this.previousBlockHash = block.previousBlockHash;
+        this.previousBlockChecksum = block.previousBlockChecksum;
+        this.bits = block.bits;
+        this.nonce = block.nonce;
+        this.version = block.version;
+        this.size = block.size;
+        this.txCount = block.txCount;
+        this.weight = block.weight;
+        this.strippedSize = block.strippedSize;
+        this.time = block.time;
+        this.medianTime = block.medianTime;
+        this.checksumRoot = block.checksumRoot;
+        this.merkleRoot = block.merkleRoot;
+        this.storageRoot = block.storageRoot;
+        this.receiptRoot = block.receiptRoot;
+        this.checksumProofs = block.checksumProofs;
+        this.transactions = this.getTransactions(block.transactions);
+    }
+    getTransactions(transactions) {
+        if (!transactions) {
+            return [];
+        }
+        const transactionArray = [];
+        for (let transaction of transactions) {
+            switch (transaction.OPNetType) {
+                case OPNetTransactionTypes.Generic:
+                    transactionArray.push(new GenericTransaction(transaction));
+                    break;
+                case OPNetTransactionTypes.Interaction:
+                    transactionArray.push(new InteractionTransaction(transaction));
+                    break;
+                case OPNetTransactionTypes.Deployment:
+                    transactionArray.push(new DeploymentTransaction(transaction));
+                    break;
+                default:
+                    throw new Error('Unknown transaction type');
+            }
+        }
+        return transactionArray;
+    }
+}

package/build/index.d.ts

@@ -0,0 +1,11 @@
+export * from './interfaces/opnet/OPNetTransactionTypes.js';
+export * from './interfaces/transactions/ITransaction.js';
+export * from './transactions/DeploymentTransaction.js';
+export * from './transactions/GenericTransaction.js';
+export * from './transactions/InteractionTransaction.js';
+export * from './transactions/Transaction.js';
+export * from './transactions/TransactionInput.js';
+export * from './transactions/TransactionOutput.js';
+export * from './providers/JSONRpcProvider.js';
+export * from './block/Block.js';
+export * from './interfaces/blocks/IBlock.js';

package/build/index.js

@@ -1,2 +1,11 @@
-"use strict";
-console.log(`The start of everything is the end of something else. The end of everything is the start of something else.`);
+export * from './interfaces/opnet/OPNetTransactionTypes.js';
+export * from './interfaces/transactions/ITransaction.js';
+export * from './transactions/DeploymentTransaction.js';
+export * from './transactions/GenericTransaction.js';
+export * from './transactions/InteractionTransaction.js';
+export * from './transactions/Transaction.js';
+export * from './transactions/TransactionInput.js';
+export * from './transactions/TransactionOutput.js';
+export * from './providers/JSONRpcProvider.js';
+export * from './block/Block.js';
+export * from './interfaces/blocks/IBlock.js';

package/build/interfaces/Block.js

@@ -0,0 +1 @@
+"use strict";

package/build/interfaces/IBlock.js

@@ -0,0 +1 @@
+"use strict";

package/build/interfaces/blocks/IBlock.d.ts

@@ -0,0 +1,28 @@
+import { BigNumberish } from 'ethers';
+import { TransactionBase } from '../../transactions/Transaction.js';
+import { OPNetTransactionTypes } from '../opnet/OPNetTransactionTypes.js';
+import { ITransaction } from '../transactions/ITransaction.js';
+export type BlockHeaderChecksumProof = Array<[number, string[]]>;
+export interface IBlockCommon {
+    height: string | BigNumberish;
+    hash: string;
+    previousBlockHash: string;
+    previousBlockChecksum: string;
+    bits: string;
+    nonce: number;
+    version: number;
+    size: number;
+    txCount: number;
+    weight: number;
+    strippedSize: number;
+    time: number;
+    medianTime: number;
+    checksumRoot: string;
+    merkleRoot: string;
+    storageRoot: string;
+    receiptRoot: string;
+    checksumProofs: BlockHeaderChecksumProof;
+}
+export interface IBlock extends IBlockCommon {
+    transactions?: ITransaction[] | TransactionBase<OPNetTransactionTypes>[];
+}

package/build/interfaces/blocks/IBlock.js

@@ -0,0 +1 @@
+export {};

package/build/interfaces/opnet/OPNetTransactionTypes.d.ts

@@ -0,0 +1,5 @@
+export declare enum OPNetTransactionTypes {
+    Generic = "Generic",
+    Deployment = "Deployment",
+    Interaction = "Interaction"
+}

package/build/interfaces/opnet/OPNetTransactionTypes.js

@@ -0,0 +1,6 @@
+export var OPNetTransactionTypes;
+(function (OPNetTransactionTypes) {
+    OPNetTransactionTypes["Generic"] = "Generic";
+    OPNetTransactionTypes["Deployment"] = "Deployment";
+    OPNetTransactionTypes["Interaction"] = "Interaction";
+})(OPNetTransactionTypes || (OPNetTransactionTypes = {}));

package/build/interfaces/transactions/ITransaction.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" />
+import { NetEvent } from '@btc-vision/bsi-binary';
+import { BigNumberish } from 'ethers';
+import { ITransactionInput, TransactionInput } from '../../transactions/TransactionInput.js';
+import { ITransactionOutput, TransactionOutput } from '../../transactions/TransactionOutput.js';
+import { OPNetTransactionTypes } from '../opnet/OPNetTransactionTypes.js';
+export interface ITransactionBase<T extends OPNetTransactionTypes> {
+    readonly id: string;
+    readonly hash: string;
+    readonly index: number;
+    readonly burnedBitcoin: string | BigNumberish;
+    readonly revert?: string | Buffer;
+    readonly inputs: ITransactionInput[] | TransactionInput[];
+    readonly outputs: ITransactionOutput[] | TransactionOutput[];
+    readonly OPNetType: T;
+}
+export interface IGenericTransaction extends ITransactionBase<OPNetTransactionTypes.Generic> {
+}
+export interface IDeploymentTransaction extends ITransactionBase<OPNetTransactionTypes.Deployment> {
+}
+export interface IInteractionTransaction extends ITransactionBase<OPNetTransactionTypes.Interaction> {
+    readonly calldata: string | Buffer;
+    readonly senderPubKeyHash: string | Buffer;
+    readonly contractSecret: string | Buffer;
+    readonly interactionPubKey: string | Buffer;
+    readonly wasCompressed: boolean;
+    readonly events: NetEvent[];
+    readonly receipt?: string | Buffer;
+    readonly receiptProofs?: string[];
+}
+export type ITransaction = IDeploymentTransaction | IInteractionTransaction | IGenericTransaction;

package/build/interfaces/transactions/ITransaction.js

@@ -0,0 +1 @@
+export {};

package/build/providers/JSONRpcProvider.d.ts

@@ -0,0 +1,12 @@
+import type { BlockTag } from 'ethers/src.ts/providers/provider.js';
+import { Block } from '../block/Block.js';
+export declare class JSONRpcProvider {
+    private readonly provider;
+    private readonly url;
+    private nextId;
+    constructor(url: string);
+    private providerUrl;
+    getBlockNumber(): Promise<number>;
+    getBlock(blockNumber: BlockTag | string, prefetchTxs?: boolean): Promise<Block>;
+    private buildJsonRpcPayload;
+}

package/build/providers/JSONRpcProvider.js

@@ -0,0 +1,48 @@
+import { JsonRpcProvider } from 'ethers';
+import { Block } from '../block/Block.js';
+export class JSONRpcProvider {
+    provider;
+    url;
+    nextId = 0;
+    constructor(url) {
+        this.url = this.providerUrl(url);
+        this.provider = new JsonRpcProvider(this.url);
+    }
+    providerUrl(url) {
+        url = url.trim();
+        if (url.endsWith('/')) {
+            return url.slice(0, -1);
+        }
+        if (url.includes('api/v1/json-rpc')) {
+            return url;
+        }
+        else {
+            return `${url}/api/v1/json-rpc`;
+        }
+    }
+    async getBlockNumber() {
+        return await this.provider.getBlockNumber();
+    }
+    async getBlock(blockNumber, prefetchTxs = false) {
+        const method = typeof blockNumber === 'string' ? 'btc_getBlockByHash' : 'btc_getBlockByNumber';
+        const payload = this.buildJsonRpcPayload(method, [
+            blockNumber,
+            prefetchTxs,
+        ]);
+        const blockData = await this.provider._send(payload);
+        const block = blockData.shift();
+        if (!block) {
+            throw new Error('Block not found');
+        }
+        const result = block.result;
+        return new Block(result);
+    }
+    buildJsonRpcPayload(method, params) {
+        return {
+            method: method,
+            params: params,
+            id: this.nextId++,
+            jsonrpc: '2.0',
+        };
+    }
+}

package/build/scripts/test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/scripts/test.js

@@ -0,0 +1,8 @@
+import { JSONRpcProvider } from '../providers/JSONRpcProvider.js';
+const provider = new JSONRpcProvider('http://localhost:9001');
+(async () => {
+    const blockNumber = await provider.getBlockNumber();
+    console.log('Current network height:', blockNumber);
+    const block = await provider.getBlock(blockNumber, true);
+    console.log('Block ->', block);
+})();

package/build/transactions/DeploymentTransaction.d.ts

@@ -0,0 +1,6 @@
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IDeploymentTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+export declare class DeploymentTransaction extends TransactionBase<OPNetTransactionTypes.Deployment> implements IDeploymentTransaction {
+    constructor(transaction: IDeploymentTransaction);
+}

package/build/transactions/DeploymentTransaction.js

@@ -0,0 +1,6 @@
+import { TransactionBase } from './Transaction.js';
+export class DeploymentTransaction extends TransactionBase {
+    constructor(transaction) {
+        super(transaction);
+    }
+}

package/build/transactions/GenericTransaction.d.ts

@@ -0,0 +1,6 @@
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IGenericTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+export declare class GenericTransaction extends TransactionBase<OPNetTransactionTypes.Generic> implements IGenericTransaction {
+    constructor(transaction: IGenericTransaction);
+}

package/build/transactions/GenericTransaction.js

@@ -0,0 +1,6 @@
+import { TransactionBase } from './Transaction.js';
+export class GenericTransaction extends TransactionBase {
+    constructor(transaction) {
+        super(transaction);
+    }
+}

package/build/transactions/InteractionTransaction.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" />
+import { NetEvent } from '@btc-vision/bsi-binary';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IInteractionTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+export declare class InteractionTransaction extends TransactionBase<OPNetTransactionTypes.Interaction> implements IInteractionTransaction {
+    readonly calldata: Buffer;
+    readonly senderPubKeyHash: Buffer;
+    readonly contractSecret: Buffer;
+    readonly interactionPubKey: Buffer;
+    readonly wasCompressed: boolean;
+    readonly events: NetEvent[];
+    readonly receipt?: Buffer;
+    readonly receiptProofs?: string[];
+    constructor(transaction: IInteractionTransaction);
+}

package/build/transactions/InteractionTransaction.js

@@ -0,0 +1,24 @@
+import { TransactionBase } from './Transaction.js';
+export class InteractionTransaction extends TransactionBase {
+    calldata;
+    senderPubKeyHash;
+    contractSecret;
+    interactionPubKey;
+    wasCompressed;
+    events;
+    receipt;
+    receiptProofs;
+    constructor(transaction) {
+        super(transaction);
+        this.calldata = Buffer.from(transaction.calldata, 'base64');
+        this.senderPubKeyHash = Buffer.from(transaction.senderPubKeyHash, 'base64');
+        this.contractSecret = Buffer.from(transaction.contractSecret, 'base64');
+        this.interactionPubKey = Buffer.from(transaction.interactionPubKey, 'base64');
+        this.wasCompressed = transaction.wasCompressed;
+        this.events = transaction.events;
+        this.receipt = transaction.receipt
+            ? Buffer.from(transaction.receipt, 'base64')
+            : undefined;
+        this.receiptProofs = transaction.receiptProofs;
+    }
+}

package/build/transactions/Transaction.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+import { BigNumberish } from 'ethers';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { ITransactionBase } from '../interfaces/transactions/ITransaction.js';
+import { TransactionInput } from './TransactionInput.js';
+import { TransactionOutput } from './TransactionOutput.js';
+export declare abstract class TransactionBase<T extends OPNetTransactionTypes> implements ITransactionBase<T> {
+    readonly id: string;
+    readonly hash: string;
+    readonly index: number;
+    readonly burnedBitcoin: BigNumberish;
+    readonly revert?: Buffer;
+    readonly inputs: TransactionInput[];
+    readonly outputs: TransactionOutput[];
+    readonly OPNetType: T;
+    protected constructor(transaction: ITransactionBase<T>);
+}

package/build/transactions/Transaction.js

@@ -0,0 +1,24 @@
+import { TransactionInput } from './TransactionInput.js';
+import { TransactionOutput } from './TransactionOutput.js';
+export class TransactionBase {
+    id;
+    hash;
+    index;
+    burnedBitcoin;
+    revert;
+    inputs;
+    outputs;
+    OPNetType;
+    constructor(transaction) {
+        this.id = transaction.id;
+        this.hash = transaction.hash;
+        this.index = transaction.index;
+        this.burnedBitcoin = transaction.burnedBitcoin;
+        this.inputs = transaction.inputs.map((input) => new TransactionInput(input));
+        this.outputs = transaction.outputs.map((output) => new TransactionOutput(output));
+        this.revert = transaction.revert
+            ? Buffer.from(transaction.revert, 'base64')
+            : undefined;
+        this.OPNetType = transaction.OPNetType;
+    }
+}

package/build/transactions/TransactionInput.d.ts

@@ -0,0 +1,16 @@
+import { ScriptSig } from '@btc-vision/bsi-bitcoin-rpc';
+export interface ITransactionInput {
+    readonly originalTransactionId: string | undefined;
+    readonly outputTransactionIndex: number | undefined;
+    readonly scriptSignature: ScriptSig | undefined;
+    readonly sequenceId: number;
+    readonly transactionInWitness?: string[];
+}
+export declare class TransactionInput implements ITransactionInput {
+    readonly originalTransactionId: string | undefined;
+    readonly outputTransactionIndex: number | undefined;
+    readonly scriptSignature: ScriptSig | undefined;
+    readonly sequenceId: number;
+    readonly transactionInWitness: string[];
+    constructor(data: ITransactionInput);
+}

package/build/transactions/TransactionInput.js

@@ -0,0 +1,14 @@
+export class TransactionInput {
+    originalTransactionId;
+    outputTransactionIndex;
+    scriptSignature;
+    sequenceId;
+    transactionInWitness = [];
+    constructor(data) {
+        this.originalTransactionId = data.originalTransactionId;
+        this.outputTransactionIndex = data.outputTransactionIndex;
+        this.scriptSignature = data.scriptSignature;
+        this.sequenceId = data.sequenceId;
+        this.transactionInWitness = data.transactionInWitness || [];
+    }
+}

package/build/transactions/TransactionOutput.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+import { ScriptPubKey } from '@btc-vision/bsi-bitcoin-rpc';
+export interface ITransactionOutput {
+    readonly index: number;
+    readonly scriptPubKey: {
+        hex: string;
+        addresses?: string[];
+        address?: string;
+    };
+    readonly value: string;
+}
+export declare class TransactionOutput {
+    readonly value: bigint;
+    readonly index: number;
+    readonly scriptPubKey: ScriptPubKey;
+    readonly script: Array<number | Buffer> | null;
+    constructor(data: ITransactionOutput);
+    private convertValue;
+}

package/build/transactions/TransactionOutput.js

@@ -0,0 +1,16 @@
+import { script } from 'bitcoinjs-lib';
+export class TransactionOutput {
+    value;
+    index;
+    scriptPubKey;
+    script;
+    constructor(data) {
+        this.value = this.convertValue(data.value);
+        this.index = data.index;
+        this.scriptPubKey = data.scriptPubKey;
+        this.script = script.decompile(Buffer.from(this.scriptPubKey.hex, 'hex'));
+    }
+    convertValue(value) {
+        return BigInt(value);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "type": "module",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "author": "BlobMaster41",
     "description": "The perfect library for building Bitcoin based applications.",
     "engines": {
@@ -44,6 +44,7 @@
     "devDependencies": {
         "@babel/preset-env": "^7.24.3",
         "@types/node": "^20.11.30",
+        "@types/ws": "^8.5.10",
         "eslint": "^8.57.0",
         "jest": "^29.7.0",
         "prettier": "^3.2.5",
@@ -51,10 +52,13 @@
         "typescript-eslint": "^7.4.0"
     },
     "dependencies": {
+        "@btc-vision/bsi-binary": "^1.0.6",
+        "@btc-vision/bsi-bitcoin-rpc": "^1.0.8",
         "@jest/types": "^29.6.3",
         "@types/jest": "^29.5.12",
         "babel-plugin-transform-import-meta": "^2.2.1",
         "bitcoinjs-lib": "^6.1.5",
+        "ethers": "^6.12.1",
         "gulp": "^4.0.2",
         "gulp-cached": "^1.1.1",
         "gulp-logger": "^0.0.2",

package/src/block/Block.ts

@@ -0,0 +1,104 @@
+import { BigNumberish } from 'ethers';
+import { BlockHeaderChecksumProof, IBlock } from '../interfaces/blocks/IBlock.js';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import {
+    IDeploymentTransaction,
+    IGenericTransaction,
+    IInteractionTransaction,
+    ITransaction,
+} from '../interfaces/transactions/ITransaction.js';
+import { DeploymentTransaction } from '../transactions/DeploymentTransaction.js';
+import { GenericTransaction } from '../transactions/GenericTransaction.js';
+import { InteractionTransaction } from '../transactions/InteractionTransaction.js';
+import { TransactionBase } from '../transactions/Transaction.js';
+
+export class Block implements IBlock {
+    public readonly height: BigNumberish;
+
+    public readonly hash: string;
+    public readonly previousBlockHash: string;
+    public readonly previousBlockChecksum: string;
+
+    public readonly bits: string;
+    public readonly nonce: number;
+    public readonly version: number;
+    public readonly size: number;
+    public readonly txCount: number;
+
+    public readonly weight: number;
+    public readonly strippedSize: number;
+
+    public readonly time: number;
+    public readonly medianTime: number;
+
+    public readonly checksumRoot: string;
+    public readonly merkleRoot: string;
+    public readonly storageRoot: string;
+    public readonly receiptRoot: string;
+
+    public readonly checksumProofs: BlockHeaderChecksumProof;
+
+    public readonly transactions?: TransactionBase<OPNetTransactionTypes>[];
+
+    constructor(block: IBlock) {
+        this.height = BigInt(block.height.toString());
+
+        this.hash = block.hash;
+        this.previousBlockHash = block.previousBlockHash;
+        this.previousBlockChecksum = block.previousBlockChecksum;
+
+        this.bits = block.bits;
+        this.nonce = block.nonce;
+        this.version = block.version;
+        this.size = block.size;
+        this.txCount = block.txCount;
+
+        this.weight = block.weight;
+        this.strippedSize = block.strippedSize;
+
+        this.time = block.time;
+        this.medianTime = block.medianTime;
+
+        this.checksumRoot = block.checksumRoot;
+        this.merkleRoot = block.merkleRoot;
+        this.storageRoot = block.storageRoot;
+        this.receiptRoot = block.receiptRoot;
+
+        this.checksumProofs = block.checksumProofs;
+
+        this.transactions = this.getTransactions(block.transactions as ITransaction[]);
+    }
+
+    private getTransactions(
+        transactions: ITransaction[],
+    ): TransactionBase<OPNetTransactionTypes>[] {
+        if (!transactions) {
+            return [];
+        }
+
+        const transactionArray: TransactionBase<OPNetTransactionTypes>[] = [];
+        for (let transaction of transactions) {
+            switch (transaction.OPNetType) {
+                case OPNetTransactionTypes.Generic:
+                    transactionArray.push(
+                        new GenericTransaction(transaction as IGenericTransaction),
+                    );
+                    break;
+                case OPNetTransactionTypes.Interaction:
+                    transactionArray.push(
+                        new InteractionTransaction(transaction as IInteractionTransaction),
+                    );
+                    break;
+                case OPNetTransactionTypes.Deployment:
+                    transactionArray.push(
+                        new DeploymentTransaction(transaction as IDeploymentTransaction),
+                    );
+                    break;
+                default:
+                    throw new Error('Unknown transaction type');
+            }
+        }
+
+        return transactionArray;
+    }
+}

package/src/index.ts

@@ -1,5 +1,12 @@
-/** First commit made to reserve the project name. */
+export * from './interfaces/opnet/OPNetTransactionTypes.js';
+export * from './interfaces/transactions/ITransaction.js';
+export * from './transactions/DeploymentTransaction.js';
+export * from './transactions/GenericTransaction.js';
+export * from './transactions/InteractionTransaction.js';
+export * from './transactions/Transaction.js';
+export * from './transactions/TransactionInput.js';
+export * from './transactions/TransactionOutput.js';
+export * from './providers/JSONRpcProvider.js';
 
-console.log(
-    `The start of everything is the end of something else. The end of everything is the start of something else.`,
-);
+export * from './block/Block.js';
+export * from './interfaces/blocks/IBlock.js';

package/src/interfaces/blocks/IBlock.ts

@@ -0,0 +1,38 @@
+import { BigNumberish } from 'ethers';
+import { TransactionBase } from '../../transactions/Transaction.js';
+import { OPNetTransactionTypes } from '../opnet/OPNetTransactionTypes.js';
+import { ITransaction } from '../transactions/ITransaction.js';
+
+export type BlockHeaderChecksumProof = Array<[number, string[]]>;
+
+export interface IBlockCommon {
+    height: string | BigNumberish;
+    hash: string;
+
+    previousBlockHash: string;
+    previousBlockChecksum: string;
+
+    bits: string;
+    nonce: number;
+    version: number;
+    size: number;
+    txCount: number;
+
+    weight: number;
+    strippedSize: number;
+
+    time: number;
+    medianTime: number;
+
+    /** Allows us to verify that the block is correct and not regenerated. */
+    checksumRoot: string;
+    merkleRoot: string;
+    storageRoot: string;
+    receiptRoot: string;
+
+    checksumProofs: BlockHeaderChecksumProof;
+}
+
+export interface IBlock extends IBlockCommon {
+    transactions?: ITransaction[] | TransactionBase<OPNetTransactionTypes>[];
+}

package/src/interfaces/opnet/OPNetTransactionTypes.ts

@@ -0,0 +1,5 @@
+export enum OPNetTransactionTypes {
+    Generic = 'Generic',
+    Deployment = 'Deployment',
+    Interaction = 'Interaction',
+}

package/src/interfaces/transactions/ITransaction.ts

@@ -0,0 +1,41 @@
+import { NetEvent } from '@btc-vision/bsi-binary';
+import { BigNumberish } from 'ethers';
+import { ITransactionInput, TransactionInput } from '../../transactions/TransactionInput.js';
+import { ITransactionOutput, TransactionOutput } from '../../transactions/TransactionOutput.js';
+import { OPNetTransactionTypes } from '../opnet/OPNetTransactionTypes.js';
+
+export interface ITransactionBase<T extends OPNetTransactionTypes> {
+    readonly id: string;
+    readonly hash: string;
+
+    readonly index: number; // Mark the order of the transaction in the block
+
+    readonly burnedBitcoin: string | BigNumberish;
+    readonly revert?: string | Buffer;
+
+    readonly inputs: ITransactionInput[] | TransactionInput[];
+    readonly outputs: ITransactionOutput[] | TransactionOutput[];
+
+    readonly OPNetType: T;
+}
+
+export interface IGenericTransaction extends ITransactionBase<OPNetTransactionTypes.Generic> {}
+
+export interface IDeploymentTransaction
+    extends ITransactionBase<OPNetTransactionTypes.Deployment> {}
+
+export interface IInteractionTransaction
+    extends ITransactionBase<OPNetTransactionTypes.Interaction> {
+    readonly calldata: string | Buffer;
+    readonly senderPubKeyHash: string | Buffer;
+    readonly contractSecret: string | Buffer;
+    readonly interactionPubKey: string | Buffer;
+
+    readonly wasCompressed: boolean;
+
+    readonly events: NetEvent[];
+    readonly receipt?: string | Buffer;
+    readonly receiptProofs?: string[];
+}
+
+export type ITransaction = IDeploymentTransaction | IInteractionTransaction | IGenericTransaction;

package/src/providers/JSONRpcProvider.ts

@@ -0,0 +1,67 @@
+import { JsonRpcPayload, JsonRpcProvider, JsonRpcResult } from 'ethers';
+import type { BlockTag } from 'ethers/src.ts/providers/provider.js';
+import { Block } from '../block/Block.js';
+import { IBlock } from '../interfaces/blocks/IBlock.js';
+
+export class JSONRpcProvider {
+    private readonly provider: JsonRpcProvider;
+    private readonly url: string;
+
+    private nextId: number = 0;
+
+    constructor(url: string) {
+        this.url = this.providerUrl(url);
+
+        this.provider = new JsonRpcProvider(this.url);
+    }
+
+    private providerUrl(url: string): string {
+        url = url.trim();
+
+        if (url.endsWith('/')) {
+            return url.slice(0, -1);
+        }
+
+        if (url.includes('api/v1/json-rpc')) {
+            return url;
+        } else {
+            return `${url}/api/v1/json-rpc`;
+        }
+    }
+
+    public async getBlockNumber(): Promise<number> {
+        return await this.provider.getBlockNumber();
+    }
+
+    public async getBlock(
+        blockNumber: BlockTag | string,
+        prefetchTxs: boolean = false,
+    ): Promise<Block> {
+        const method =
+            typeof blockNumber === 'string' ? 'btc_getBlockByHash' : 'btc_getBlockByNumber';
+
+        const payload: JsonRpcPayload = this.buildJsonRpcPayload(method, [
+            blockNumber,
+            prefetchTxs,
+        ]);
+        
+        const blockData: JsonRpcResult[] = await this.provider._send(payload);
+        const block = blockData.shift();
+
+        if (!block) {
+            throw new Error('Block not found');
+        }
+
+        const result: IBlock = block.result;
+        return new Block(result);
+    }
+
+    private buildJsonRpcPayload(method: string, params: unknown[]): JsonRpcPayload {
+        return {
+            method: method,
+            params: params,
+            id: this.nextId++,
+            jsonrpc: '2.0',
+        };
+    }
+}

package/src/scripts/test.ts

@@ -0,0 +1,11 @@
+import { JSONRpcProvider } from '../providers/JSONRpcProvider.js';
+
+const provider: JSONRpcProvider = new JSONRpcProvider('http://localhost:9001');
+
+(async () => {
+    const blockNumber = await provider.getBlockNumber();
+    console.log('Current network height:', blockNumber);
+
+    const block = await provider.getBlock(blockNumber, true);
+    console.log('Block ->', block);
+})();

package/src/transactions/DeploymentTransaction.ts

@@ -0,0 +1,12 @@
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IDeploymentTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+
+export class DeploymentTransaction
+    extends TransactionBase<OPNetTransactionTypes.Deployment>
+    implements IDeploymentTransaction
+{
+    constructor(transaction: IDeploymentTransaction) {
+        super(transaction);
+    }
+}

package/src/transactions/GenericTransaction.ts

@@ -0,0 +1,12 @@
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IGenericTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+
+export class GenericTransaction
+    extends TransactionBase<OPNetTransactionTypes.Generic>
+    implements IGenericTransaction
+{
+    constructor(transaction: IGenericTransaction) {
+        super(transaction);
+    }
+}

package/src/transactions/InteractionTransaction.ts

@@ -0,0 +1,39 @@
+import { NetEvent } from '@btc-vision/bsi-binary';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { IInteractionTransaction } from '../interfaces/transactions/ITransaction.js';
+import { TransactionBase } from './Transaction.js';
+
+export class InteractionTransaction
+    extends TransactionBase<OPNetTransactionTypes.Interaction>
+    implements IInteractionTransaction
+{
+    public readonly calldata: Buffer;
+    public readonly senderPubKeyHash: Buffer;
+    public readonly contractSecret: Buffer;
+    public readonly interactionPubKey: Buffer;
+
+    public readonly wasCompressed: boolean;
+    public readonly events: NetEvent[];
+
+    public readonly receipt?: Buffer;
+
+    public readonly receiptProofs?: string[];
+
+    constructor(transaction: IInteractionTransaction) {
+        super(transaction);
+
+        this.calldata = Buffer.from(transaction.calldata as string, 'base64');
+        this.senderPubKeyHash = Buffer.from(transaction.senderPubKeyHash as string, 'base64');
+        this.contractSecret = Buffer.from(transaction.contractSecret as string, 'base64');
+        this.interactionPubKey = Buffer.from(transaction.interactionPubKey as string, 'base64');
+
+        this.wasCompressed = transaction.wasCompressed;
+
+        this.events = transaction.events;
+        this.receipt = transaction.receipt
+            ? Buffer.from(transaction.receipt as string, 'base64')
+            : undefined;
+
+        this.receiptProofs = transaction.receiptProofs;
+    }
+}

package/src/transactions/Transaction.ts

@@ -0,0 +1,42 @@
+import { BigNumberish } from 'ethers';
+import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes.js';
+import { ITransactionBase } from '../interfaces/transactions/ITransaction.js';
+import { TransactionInput } from './TransactionInput.js';
+import { ITransactionOutput, TransactionOutput } from './TransactionOutput.js';
+
+export abstract class TransactionBase<T extends OPNetTransactionTypes>
+    implements ITransactionBase<T>
+{
+    public readonly id: string;
+    public readonly hash: string;
+
+    public readonly index: number;
+
+    public readonly burnedBitcoin: BigNumberish;
+    public readonly revert?: Buffer;
+
+    public readonly inputs: TransactionInput[];
+    public readonly outputs: TransactionOutput[];
+
+    public readonly OPNetType: T;
+
+    protected constructor(transaction: ITransactionBase<T>) {
+        this.id = transaction.id;
+        this.hash = transaction.hash;
+
+        this.index = transaction.index;
+
+        this.burnedBitcoin = transaction.burnedBitcoin;
+
+        this.inputs = transaction.inputs.map((input) => new TransactionInput(input));
+        this.outputs = transaction.outputs.map(
+            (output) => new TransactionOutput(output as ITransactionOutput),
+        );
+
+        this.revert = transaction.revert
+            ? Buffer.from(transaction.revert as string, 'base64')
+            : undefined;
+
+        this.OPNetType = transaction.OPNetType;
+    }
+}

package/src/transactions/TransactionInput.ts

@@ -0,0 +1,31 @@
+import { ScriptSig } from '@btc-vision/bsi-bitcoin-rpc';
+
+export interface ITransactionInput {
+    readonly originalTransactionId: string | undefined;
+    readonly outputTransactionIndex: number | undefined;
+
+    readonly scriptSignature: ScriptSig | undefined;
+    readonly sequenceId: number;
+
+    readonly transactionInWitness?: string[];
+}
+
+export class TransactionInput implements ITransactionInput {
+    public readonly originalTransactionId: string | undefined;
+    public readonly outputTransactionIndex: number | undefined;
+
+    public readonly scriptSignature: ScriptSig | undefined;
+    public readonly sequenceId: number;
+
+    public readonly transactionInWitness: string[] = [];
+
+    constructor(data: ITransactionInput) {
+        this.originalTransactionId = data.originalTransactionId;
+        this.outputTransactionIndex = data.outputTransactionIndex;
+
+        this.scriptSignature = data.scriptSignature;
+
+        this.sequenceId = data.sequenceId;
+        this.transactionInWitness = data.transactionInWitness || [];
+    }
+}

package/src/transactions/TransactionOutput.ts

@@ -0,0 +1,33 @@
+import { ScriptPubKey } from '@btc-vision/bsi-bitcoin-rpc';
+import { script } from 'bitcoinjs-lib';
+
+export interface ITransactionOutput {
+    readonly index: number;
+    readonly scriptPubKey: {
+        hex: string;
+        addresses?: string[];
+        address?: string;
+    };
+
+    readonly value: string;
+}
+
+export class TransactionOutput {
+    public readonly value: bigint;
+    public readonly index: number;
+
+    public readonly scriptPubKey: ScriptPubKey;
+    public readonly script: Array<number | Buffer> | null;
+
+    constructor(data: ITransactionOutput) {
+        this.value = this.convertValue(data.value);
+        this.index = data.index;
+
+        this.scriptPubKey = data.scriptPubKey;
+        this.script = script.decompile(Buffer.from(this.scriptPubKey.hex, 'hex'));
+    }
+
+    private convertValue(value: string): bigint {
+        return BigInt(value);
+    }
+}