quicknode-sdk 0.8.1

Core library for quicknode sdk
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

[package]
name = "quicknode-sdk"
version = "0.8.1"
edition.workspace = true
license.workspace = true
description = "Core library for quicknode sdk"
repository = "https://github.com/quicknode/sdk"
readme = "README.md"
keywords = ["quicknode", "blockchain", "web3", "sdk"]
categories = ["api-bindings", "web-programming"]

[lints]
workspace = true

[features]
python = ["pyo3", "pyo3-async-runtimes", "pyo3-stub-gen"]
node = ["napi", "napi-derive"]
ruby = ["magnus"]
rust = ["bon"]
extension-module = ["pyo3/extension-module"]

# Crypto-micropayment lanes for rpc.call. Layered so a crates.io consumer can
# opt into only the pay-chains it needs; wheels/npm/gems ship features-on, so
# "zero cost when off" is true only for the crate itself.
# payments       = x402/EVM (EIP-712 TransferWithAuthorization).
# payments-svm   = + x402/Solana (hand-rolled v0 tx: compute budget, SPL
#                  TransferChecked, memo; ed25519).
# payments-tempo = + MPP/Tempo (native type-0x76 tx via tempo-primitives).
payments = ["dep:k256", "dep:sha3", "dep:hex", "dep:base64", "dep:rand"]
payments-svm = ["payments", "dep:ed25519-dalek", "dep:bs58", "dep:sha2"]
# tempo-primitives MUST stay default-features=false: its defaults pull revm +
# aws-lc-rs (C/cmake) which break cross+zig at glibc-2.17/musl. The base64 dep
# is force-included with the `alloc` feature to work around an upstream no_std
# feature-unification bug (tempo-primitives no-default-features won't compile
# without base64/alloc present in the tree).
payments-tempo = ["payments", "dep:tempo-primitives", "dep:alloy-primitives", "dep:alloy-consensus", "dep:alloy-rlp"]

[dependencies]
thiserror = "1.0"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
reqwest = { version = "0.13.2", default-features = false, features = ["json", "query", "rustls", "http2"] }
pyo3 = { workspace = true, optional = true, features = ["experimental-async"] }
pyo3-async-runtimes = { workspace = true, optional = true, features = ["tokio-runtime"] }
napi = { workspace = true, optional = true, features = ["async", "tokio_rt"] }
napi-derive = { workspace = true, optional = true }
pyo3-stub-gen = { workspace = true, optional = true }
magnus = { workspace = true, optional = true }
bon = { version = "3.9", optional = true }
config = "0.15"
url = "2.5.8"
secrecy = "0.8"
# sync-only: provides tokio::sync::Mutex for single-flight JWT refresh in the
# rpc client without pulling in the tokio runtime. The async runtime itself is
# supplied by the caller (bindings or the user's own runtime).
tokio = { version = "1", default-features = false, features = ["sync"] }

# ── Payment lane crypto (feature-gated) ──────────────────────────────────────
# secp256k1 signing for EIP-712 (x402/EVM) and Tempo (MPP). k256 0.14's
# sign_prehash_recoverable returns the tuple directly (no Result).
k256 = { version = "0.14", optional = true }
sha3 = { version = "0.10", optional = true } # keccak256 for EIP-712 + Tempo memo
hex = { version = "0.4", optional = true }
rand = { version = "0.8", optional = true } # random EIP-3009 nonce
# base64 is also force-enabled with `alloc` to unify features for
# tempo-primitives' no_std build (see the payments-tempo feature comment).
base64 = { version = "0.22", optional = true, features = ["alloc"] }
# x402/Solana: ed25519 signing + base58 addresses + sha256 for PDA/ATA derivation.
ed25519-dalek = { version = "2", optional = true }
bs58 = { version = "0.5", optional = true }
sha2 = { version = "0.10", optional = true }
# MPP/Tempo native type-0x76 tx. default-features=false is REQUIRED (see feature
# comment). alloy-* pinned to the versions tempo-primitives 1.8.1 builds against.
tempo-primitives = { version = "1.8.1", optional = true, default-features = false }
alloy-primitives = { version = "1.6", optional = true }
alloy-consensus = { version = "2.1", optional = true }
alloy-rlp = { version = "0.3", optional = true }

[[example]]
name = "admin"
required-features = ["rust"]

[[example]]
name = "admin_e2e"
required-features = ["rust"]

[[example]]
name = "streams"
required-features = ["rust"]

[[example]]
name = "streams_e2e"
required-features = ["rust"]

[[example]]
name = "webhooks_e2e"
required-features = ["rust"]

[[example]]
name = "rpc"
required-features = ["rust"]

[[example]]
name = "rpc_payment"
required-features = ["rust", "payments", "payments-svm", "payments-tempo"]

[dev-dependencies]
tokio = { version = "1.0", features = ["rt-multi-thread", "macros"] }
wiremock = "0.6"