polyrel 0.3.2

Unofficial Polymarket relayer client
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

#![cfg_attr(not(feature = "std"), no_std)]
//! Typed building blocks for Polymarket relayer payloads.
//!
//! The crate is split into two layers:
//!
//! - generic calldata builders in modules like [`erc20`], [`erc1155`], and [`ctf`]
//! - Polymarket V2 collateral helpers in [`collateral`]
//! - deposit-wallet relayer builders in [`deposit_wallet`]
//! - Safe-specific payload construction in [`safe`]
//!
//! The optional [`client`] module adds a raw relayer HTTP client behind the
//! `client` feature.
//!
//! # Examples
//!
//! Build a gasless Safe execution draft for an ERC-20 approval:
//!
//! ```no_run
//! use alloy_primitives::{Address, U256, address, b256};
//! use polyrel::{
//!     NonEmptyCalls, erc20,
//!     safe::{self, ChainId, SafeExecutionContext, SafeGasParams, SafeNonce},
//! };
//!
//! let call = erc20::approve(
//!     address!("2791Bca1f2de4661ED88A30C99A7a9449Aa84174"),
//!     address!("4d97dcd97ec945f40cf65f87097ace5ea0476045"),
//!     U256::from(1_000_000_u64),
//! );
//! let context = SafeExecutionContext::builder()
//!     .owner(address!("6e0c80c90ea6c15917308f820eac91ce2724b5b5"))
//!     .chain_id(ChainId::new(137.try_into().unwrap()))
//!     .safe_factory(address!("aacfeea03eb1561c4e67d661e40682bd20e3541b"))
//!     .safe_init_code_hash(
//!         b256!("2bce2127ff07fb632d16c8347c4ebf501f4841168bed00d9e6ef715ddb6fcecf"),
//!     )
//!     .safe_multisend(address!("a238cbeb142c10ef7ad8442c6d1f9e89e07e7761"))
//!     .nonce(SafeNonce::new(U256::ZERO))
//!     .gas_params(
//!         SafeGasParams::builder()
//!             .safe_txn_gas(U256::ZERO)
//!             .base_gas(U256::ZERO)
//!             .gas_price(U256::ZERO)
//!             .gas_token(Address::ZERO)
//!             .refund_receiver(Address::ZERO)
//!             .build(),
//!     )
//!     .build();
//! let _draft = safe::build_execution_draft(&context, NonEmptyCalls::from_one(call)).unwrap();
//! ```
//!
//! Create a relayer client when the `client` feature is enabled:
//!
//! ```no_run
//! # #[cfg(feature = "client")]
//! # async fn demo() -> Result<(), polyrel::PolyrelError> {
//! use alloy_primitives::address;
//! use polyrel::client::{RelayerApiKeyAuth, RelayerBaseUrl, RelayerClient};
//! use secrecy::SecretString;
//!
//! let base_url = RelayerBaseUrl::parse("https://relayer-v2.polymarket.com")?;
//! let _client = RelayerClient::new(base_url).authenticate_relayer(RelayerApiKeyAuth::new(
//!     SecretString::from("replace-me"),
//!     address!("6e0c80c90ea6c15917308f820eac91ce2724b5b5"),
//! ));
//! # Ok(())
//! # }
//! ```
//!
//! Build a deposit-wallet deployment request and a follow-up wallet batch:
//!
//! ```no_run
//! use alloy_primitives::{U256, address};
//! use polyrel::{
//!     NonEmptyCalls, deposit_wallet, erc20,
//!     safe::ChainId,
//! };
//!
//! let create_context = deposit_wallet::DepositWalletCreateContext::builder()
//!     .owner(address!("6e0c80c90ea6c15917308f820eac91ce2724b5b5"))
//!     .deposit_wallet_factory(address!("00000000000fb5c9adea0298d729a0cb3823cc07"))
//!     .deposit_wallet_implementation(address!("58ca52ebe0dadfdf531cde7062e76746de4db1eb"))
//!     .build();
//! let create_draft = deposit_wallet::build_create_draft(&create_context);
//! let deposit_wallet = create_draft.deposit_wallet_address();
//!
//! let approve = erc20::approve(
//!     address!("c011a7e12a19f7b1f670d46f03b03f3342e82dfb"),
//!     address!("4d97dcd97ec945f40cf65f87097ace5ea0476045"),
//!     U256::MAX,
//! );
//! let batch_context = deposit_wallet::DepositWalletBatchContext::builder()
//!     .owner(address!("6e0c80c90ea6c15917308f820eac91ce2724b5b5"))
//!     .chain_id(ChainId::new(137.try_into().unwrap()))
//!     .deposit_wallet_factory(address!("00000000000fb5c9adea0298d729a0cb3823cc07"))
//!     .deposit_wallet(deposit_wallet)
//!     .nonce(deposit_wallet::DepositWalletNonce::new(U256::ZERO))
//!     .deadline(deposit_wallet::DepositWalletDeadline::new(U256::from(1_760_000_000_u64)))
//!     .build();
//! let _batch_draft =
//!     deposit_wallet::build_batch_draft(&batch_context, NonEmptyCalls::from_one(approve))
//!         .unwrap();
//! ```

extern crate alloc;

/// Raw Polymarket relayer HTTP client and authenticated transport helpers.
pub mod client;

/// Polymarket V2 pUSD collateral helpers.
pub mod collateral;

/// Polymarket deposit-wallet relayer builders.
pub mod deposit_wallet;

/// Conditional Tokens Framework calldata builders.
pub mod ctf;

/// ERC-1155 calldata builders.
pub mod erc1155;

/// ERC-20 calldata builders.
pub mod erc20;

/// Neg-risk adapter calldata builders.
pub mod neg_risk;

/// Polymarket-specific approval recipes built on top of the generic token helpers.
pub mod polymarket;

/// Safe-specific payload construction for deployment and execution requests.
pub mod safe;

mod call;
mod error;

/// Generic EVM call envelope used throughout the crate.
pub use call::Call;

/// Non-empty collection of [`Call`] values.
pub use call::NonEmptyCalls;

/// Error type used by the crate.
pub use error::PolyrelError;