Default offer params (#34)

* add note on defaults

* simplify

* use warning

* add note

* Style fixes: remove intensifiers and tighten phrasing

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: sasha <33594434+sasha-computer@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: 3 people

developers/tooling/sdk.mdx

@@ -119,12 +119,7 @@ async fn proof_submission(signer: &PrivateKeySigner, rpc_url: Url) -> anyhow::Re
     // Build the request.
     let request = client.new_request()
         .with_program(std::fs::read("guest.bin")?)
-        .with_stdin(42u32.to_le_bytes())
-        .with_offer(OfferParams::builder()
-            .ramp_up_period(30)
-            .lock_timeout(150)
-            .timeout(300)
-        );
+        .with_stdin(42u32.to_le_bytes());
 
     // Submit the request.
     let (request_id, expires_at) = client.submit(request).await?;

developers/tutorials/callbacks.mdx

@@ -46,14 +46,6 @@ let request = client.new_request()
         RequirementParams::builder()
             .callback_address(counter_address)
             .callback_gas_limit(100_000)
-    )
-    .with_offer(
-        OfferParams::builder()
-            .min_price(parse_ether("0.001")?)
-            .max_price(parse_ether("0.002")?)
-            .timeout(1000)
-            .lock_timeout(1000)
-            .ramp_up_period(100)
     );
 
 // Submit the request

developers/tutorials/proof-types.mdx

@@ -32,14 +32,7 @@ Boundless supports requesting a raw Groth16 proof instead of a merkle inclusion
 let request = client.new_request()
     .with_program(program)
     .with_stdin(input)
-    .with_groth16_proof()  // Request raw Groth16 proof
-    .with_offer(
-        OfferParams::builder()
-            .min_price(parse_ether("0.001")?)
-            .max_price(parse_ether("0.002")?)
-            .timeout(1000)
-            .lock_timeout(1000)
-    );
+    .with_groth16_proof();  // Request raw Groth16 proof
 ```
 
 ### Request a Blake3 Groth16 Proof
@@ -58,14 +51,7 @@ let request = client
     .new_request()
     .with_program(program)
     .with_stdin(input)
-    .with_blake3_groth16_proof()  // Request Blake3 Groth16 proof
-    .with_offer(
-        OfferParams::builder()
-            .min_price(parse_ether("0.001")?)
-            .max_price(parse_ether("0.002")?)
-            .timeout(1000)
-            .lock_timeout(1000)
-    );
+    .with_blake3_groth16_proof();  // Request Blake3 Groth16 proof
 ```
 
 ## Considerations
@@ -110,14 +96,7 @@ In the composition example, we first request a raw Groth16 proof from the Boundl
 let request = client.new_request()
     .with_program(program)
     .with_stdin(input)
-    .with_groth16_proof()  // Request raw Groth16 proof
-    .with_offer(
-        OfferParams::builder()
-            .min_price(parse_ether("0.001")?)
-            .max_price(parse_ether("0.002")?)
-            .timeout(1000)
-            .lock_timeout(1000)
-    );
+    .with_groth16_proof();  // Request raw Groth16 proof
 ```
 
 We then provide the Groth16 proof as input to the `IDENTITY` zkVM guest program, and verify the proof.

developers/tutorials/request.mdx

@@ -321,6 +321,12 @@ The [Offer](/developers/tutorials/auction) specifies how much the requestor will
 
 The Client helps you build requests and set these parameters. Within the client, the [OfferLayer](https://docs.rs/boundless-market/latest/boundless_market/request_builder/offer_layer/struct.OfferLayer.html) creates the offer. It contains a set of defaults, and logic to assign a price to your request.
 
+<Warning>
+By default, the parameters maximize the chance of request fulfillment.
+They use relaxed timeouts, dynamic market pricing, and recommended collateral.
+Change them only when necessary.
+</Warning>
+
 There are two ways to configure auction parameters:
 
 1. Using `client_builder.config_offer_layer` to configure the offer building logic.
@@ -390,6 +396,10 @@ let client = Client::builder()
 
 With this configuration, the SDK will execute the request to estimate cycles and calculate appropriate prices.
 
+<Note>
+The SDK warns when an overridden parameter may reduce fulfillment chances.
+</Note>
+
 ### Funding Modes
 
 <Warning>

developers/tutorials/smart-contract-requestor.mdx

@@ -101,14 +101,7 @@ Then we create our proof request, setting a `Requirement` that the journal shoul
 // Create the request params
 let request = client.new_request()
     .with_program_url(program_url)?
-    .with_stdin(input)
-    .with_offer(
-        OfferParams::builder()
-            .min_price(parse_ether("0.001")?)
-            .max_price(parse_ether("0.002")?)
-            .lock_timeout(1000)
-            .timeout(2000)
-    );
+    .with_stdin(input);
 
 // Build the request
 let request = client.build_request(request).await?;

developers/tutorials/tracking.mdx

@@ -26,8 +26,7 @@ Here's how to wait for a request to be fulfilled:
 // Submit your request
 let request = client.new_request()
     .with_program(program)
-    .with_stdin(input)
-    .with_offer(offer_params);
+    .with_stdin(input);
 
 let (request_id, expires_at) = client.submit(request).await?;