mirror of
https://github.com/Xahau/xahau.js.git
synced 2025-11-19 19:55:51 +00:00
38b385969b
- Removes need for bundlers to polyfill the `Buffer` class. `UInt8Array` are used instead which are native to the browser and node. - Reduces bundle size 7.1kb gzipped and eliminates 4 runtime dependencies: `base-x`, `base64-js`, `buffer`, and `ieee754`. BREAKING CHANGE: All methods that previously took a `Buffer` now accept a `UInt8Array`. --------- Co-authored-by: Jackson Mills <jmills@ripple.com>
125 lines
2.8 KiB
Markdown
125 lines
2.8 KiB
Markdown
# @xrplf/isomorphic
|
|
|
|
A collection of isomorphic implementations of crypto and utility functions.
|
|
|
|
Browser implementations of cryptographic functions use `@noble/hashes` and `crypto` for node .
|
|
|
|
### Hashes
|
|
|
|
All hash functions operate similarly to `@noble/hashes` and have the following properties:
|
|
|
|
- They can be called directly by providing a Uint8Array or string which will be converted into a UInt8Array via UTF-8 encoding (not hex).
|
|
- They all return a UInt8Array.
|
|
|
|
```
|
|
function hash(message: Uint8Array | string): Uint8Array;
|
|
hash(new Uint8Array([1, 3]));
|
|
hash('string') == hash(new TextEncoder().encode('string'));
|
|
```
|
|
|
|
All hash functions can be constructed via `hash.create()` method:
|
|
|
|
- The result is `Hash` subclass instance, which has `update()` and `digest()` methods.
|
|
- `digest()` finalizes the hash and makes it no longer usable
|
|
|
|
```typescript
|
|
hash
|
|
.create()
|
|
.update(new Uint8Array([1, 3]))
|
|
.digest();
|
|
```
|
|
|
|
### `@xrplf/isomorphic/ripemd160`
|
|
```typescript
|
|
import { ripemd160 } from '@xrplf/isomorphic/ripemd160';
|
|
const hashA = ripemd160('abc');
|
|
const hashB = ripemd160
|
|
.create()
|
|
.update(Uint8Array.from([1, 2, 3]))
|
|
.digest();
|
|
```
|
|
|
|
### `@xrplf/isomorphic/sha256`
|
|
|
|
```typescript
|
|
import { sha256 } from '@xrplf/isomorphic/sha256';
|
|
const hashA = sha256('abc');
|
|
const hashB = sha256
|
|
.create()
|
|
.update(Uint8Array.from([1, 2, 3]))
|
|
.digest();
|
|
```
|
|
|
|
### `@xrplf/isomorphic/sha512`
|
|
|
|
```typescript
|
|
import { sha512 } from '@xrplf/isomorphic/sha512';
|
|
const hashA = sha512('abc');
|
|
const hashB = sha512
|
|
.create()
|
|
.update(Uint8Array.from([1, 2, 3]))
|
|
.digest();
|
|
```
|
|
|
|
## Utilities
|
|
|
|
### `@xrplf/isomorphic/utils`
|
|
|
|
#### randomBytes
|
|
|
|
Create an UInt8Array of the supplied size
|
|
|
|
```typescript
|
|
import { randomBytes } from @xrplf/isomorphic/utils
|
|
|
|
console.log(randomBytes(12)) // Uint8Array(12) [95, 236, 188, 55, 208, 128, 161, 249, 171, 57, 141, 7]
|
|
```
|
|
|
|
#### bytesToHex
|
|
|
|
Convert an UInt8Array to hex.
|
|
|
|
```typescript
|
|
import { bytesToHex } from @xrplf/isomorphic/utils
|
|
|
|
console.log(bytesToHex([222, 173, 190, 239])) // "DEADBEEF"
|
|
```
|
|
|
|
#### hexToBytes
|
|
|
|
Convert hex to an UInt8Array.
|
|
|
|
```typescript
|
|
import { hexToBytes } from @xrplf/isomorphic/utils
|
|
|
|
console.log(hexToBytes('DEADBEEF')) // [222, 173, 190, 239]
|
|
```
|
|
|
|
#### hexToString
|
|
|
|
Converts hex to its string equivalent. Useful to read the Domain field and some Memos.
|
|
|
|
```typescript
|
|
import { hexToString } from @xrplf/isomorphic/utils
|
|
|
|
console.log(hexToString('6465616462656566D68D')) // "deadbeef֍"
|
|
```
|
|
|
|
#### stringToHex
|
|
|
|
Converts a utf-8 to its hex equivalent. Useful for Memos.
|
|
|
|
```typescript
|
|
import { stringToHex } from @xrplf/isomorphic/utils
|
|
|
|
console.log(stringToHex('deadbeef֍')) // "6465616462656566D68D"
|
|
```
|
|
|
|
### `@xrplf/isomorphic/ws`
|
|
|
|
```typescript
|
|
import WebSocket from '@xrplf/isomorphic/ws'
|
|
|
|
const socket = new WebSocket('wss://localhost:8080')
|
|
```
|