@burstjs/contracts
Advanced tools
Generic HTTP client that is used as a network provider for @burst/core.
@burstjs/contracts can be used with NodeJS or Web. Two formats are available
Install using npm:
npm install @burstjs/contracts
or using yarn:
yarn add @burstjs/contracts
// TO DO
<script>Each package is available as bundled standalone library using IIFE.
This way burstJS can be used also within <script>-Tags.
This might be useful for Wordpress and/or other PHP applications.
Just import the package using the HTML <script> tag.
<script src='https://cdn.jsdelivr.net/npm/@burstjs/http/dist/burstjs.http.min.js'></script>
// TO DO
See more here:
@burstjs/contracts Online Documentation
Helper class for contracts
A contract owns additional data, which is split in 8 byte blocks. The content is encoded in hexadecimal representation and big endianness. This class facilitates access to these data
Size of Code Pages in bytes
Kind: inner constant of contracts
Calculates the minimum creation fee of the contract
Kind: inner method of contracts
Returns:
The minimum fee expressed in Planck
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Counts the code pages for given machine code
Kind: inner method of contracts
Returns:
The number of code pages for the passed code
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Copyright (c) 2019 Burst Apps Team
Credits to AJ ONeal for the two-complements stuff https://coolaj86.com/articles/convert-decimal-to-hex-with-js-bigints/
Kind: inner method of contracts
Generates a method call message of a contracts public method. The message can be sent using for example
[[MessageApi.sendMessage]] with messageIsText = false or [[ContractApi.callMethod]]]
Kind: inner method of contracts
Returns:
A hex string that can be used as contracts transaction message
| Param | Description |
|---|---|
| args | The argument object |
Extracts a variables value as hexadecimal string from a contract's machine data
This is a generic function to extract arbitrary data from a contract. It's recommended to use the [[ContractDataView]] class instead
Kind: inner method of contracts
Returns:
The value as hexadecimal string (already considering endianness)
| Param | Default | Description |
|---|---|---|
| contract | The contract | |
| position | The variables position | |
| length | 16 | The length of data to be extracted |
Size of Code Pages in bytes
Kind: inner constant of contracts
Calculates the minimum creation fee of the contract
Kind: inner method of contracts
Returns:
The minimum fee expressed in Planck
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Counts the code pages for given machine code
Kind: inner method of contracts
Returns:
The number of code pages for the passed code
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Copyright (c) 2019 Burst Apps Team
Credits to AJ ONeal for the two-complements stuff https://coolaj86.com/articles/convert-decimal-to-hex-with-js-bigints/
Kind: inner method of contracts
Generates a method call message of a contracts public method. The message can be sent using for example
[[MessageApi.sendMessage]] with messageIsText = false or [[ContractApi.callMethod]]]
Kind: inner method of contracts
Returns:
A hex string that can be used as contracts transaction message
| Param | Description |
|---|---|
| args | The argument object |
Extracts a variables value as hexadecimal string from a contract's machine data
This is a generic function to extract arbitrary data from a contract. It's recommended to use the [[ContractDataView]] class instead
Kind: inner method of contracts
Returns:
The value as hexadecimal string (already considering endianness)
| Param | Default | Description |
|---|---|---|
| contract | The contract | |
| position | The variables position | |
| length | 16 | The length of data to be extracted |
Size of Code Pages in bytes
Kind: inner constant of contracts
Calculates the minimum creation fee of the contract
Kind: inner method of contracts
Returns:
The minimum fee expressed in Planck
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Counts the code pages for given machine code
Kind: inner method of contracts
Returns:
The number of code pages for the passed code
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Copyright (c) 2019 Burst Apps Team
Credits to AJ ONeal for the two-complements stuff https://coolaj86.com/articles/convert-decimal-to-hex-with-js-bigints/
Kind: inner method of contracts
Generates a method call message of a contracts public method. The message can be sent using for example
[[MessageApi.sendMessage]] with messageIsText = false or [[ContractApi.callMethod]]]
Kind: inner method of contracts
Returns:
A hex string that can be used as contracts transaction message
| Param | Description |
|---|---|
| args | The argument object |
Extracts a variables value as hexadecimal string from a contract's machine data
This is a generic function to extract arbitrary data from a contract. It's recommended to use the [[ContractDataView]] class instead
Kind: inner method of contracts
Returns:
The value as hexadecimal string (already considering endianness)
| Param | Default | Description |
|---|---|---|
| contract | The contract | |
| position | The variables position | |
| length | 16 | The length of data to be extracted |
Size of Code Pages in bytes
Kind: inner constant of contracts
Calculates the minimum creation fee of the contract
Kind: inner method of contracts
Returns:
The minimum fee expressed in Planck
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Counts the code pages for given machine code
Kind: inner method of contracts
Returns:
The number of code pages for the passed code
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Copyright (c) 2019 Burst Apps Team
Credits to AJ ONeal for the two-complements stuff https://coolaj86.com/articles/convert-decimal-to-hex-with-js-bigints/
Kind: inner method of contracts
Generates a method call message of a contracts public method. The message can be sent using for example
[[MessageApi.sendMessage]] with messageIsText = false or [[ContractApi.callMethod]]]
Kind: inner method of contracts
Returns:
A hex string that can be used as contracts transaction message
| Param | Description |
|---|---|
| args | The argument object |
Extracts a variables value as hexadecimal string from a contract's machine data
This is a generic function to extract arbitrary data from a contract. It's recommended to use the [[ContractDataView]] class instead
Kind: inner method of contracts
Returns:
The value as hexadecimal string (already considering endianness)
| Param | Default | Description |
|---|---|---|
| contract | The contract | |
| position | The variables position | |
| length | 16 | The length of data to be extracted |
Size of Code Pages in bytes
Kind: inner constant of contracts
Calculates the minimum creation fee of the contract
Kind: inner method of contracts
Returns:
The minimum fee expressed in Planck
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Counts the code pages for given machine code
Kind: inner method of contracts
Returns:
The number of code pages for the passed code
| Param | Description |
|---|---|
| hexCode | The contracts code in hex form |
Copyright (c) 2019 Burst Apps Team
Credits to AJ ONeal for the two-complements stuff https://coolaj86.com/articles/convert-decimal-to-hex-with-js-bigints/
Kind: inner method of contracts
Generates a method call message of a contracts public method. The message can be sent using for example
[[MessageApi.sendMessage]] with messageIsText = false or [[ContractApi.callMethod]]]
Kind: inner method of contracts
Returns:
A hex string that can be used as contracts transaction message
| Param | Description |
|---|---|
| args | The argument object |
Extracts a variables value as hexadecimal string from a contract's machine data
This is a generic function to extract arbitrary data from a contract. It's recommended to use the [[ContractDataView]] class instead
Kind: inner method of contracts
Returns:
The value as hexadecimal string (already considering endianness)
| Param | Default | Description |
|---|---|---|
| contract | The contract | |
| position | The variables position | |
| length | 16 | The length of data to be extracted |
Helper class for contracts
A contract owns additional data, which is split in 8 byte blocks. The content is encoded in hexadecimal representation and big endianness. This class facilitates access to these data
Kind: global class
The length of a contracts variable (considering Hex notation)
Kind: instance method of ContractDataView
Returns:
Get the contract
Kind: instance method of ContractDataView
Returns:
The number of code pages
Get a variable as string
Kind: instance method of ContractDataView
Returns:
The data as string (Utf-8)
| Param | Description |
|---|---|
| index | The index of variable (starting at 0) |
Get multiple data blocks as string
Kind: instance method of ContractDataView
Returns:
The data as string (Utf-8)
| Param | Description |
|---|---|
| index | The index of variable (starting at 0) |
| count | Number of blocks |
Get a variable as decimal (string)
Kind: instance method of ContractDataView
Returns:
The data as a decimal string sequence
| Param | Description |
|---|---|
| index | The index of variable (starting at 0) |
Get a variable at given position/index
Kind: instance method of ContractDataView
Returns:
The data as hexadecimal string (in little endianness)
| Param | Description |
|---|---|
| index | The index of variable (starting at 0) |
Get a hexadecimal data block of arbitrary length at given position/index
Kind: instance method of ContractDataView
Returns:
The data as hexadecimal string (in little endianness)
| Param | Description |
|---|---|
| index | The index of variable (starting at 0) |
| length | The length of the data block (must be a multiple of 2) |
FAQs
Smart Contracts package for BURST
The npm package @burstjs/contracts receives a total of 0 weekly downloads. As such, @burstjs/contracts popularity was classified as not popular.
We found that @burstjs/contracts demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.