feat: python order processing

Author: reednaa

src/content/docs/protocol/v2/solver.mdx

@@ -143,7 +143,7 @@ async function submitOrder(): bool {
   });
   const parsedResponse = await response.json() as { success: bool };
 
-  return fetchedOrders;
+  return parsedResponse.success;
 }
 ```
 
@@ -152,13 +152,20 @@ async function submitOrder(): bool {
 
 ```python
 import requests
+import json
 
 API_URL = "https://orders.catalyst.exchange/"
 
-def get_orders():
-    response = requests.post(API_URL+ "submitOrder/", data)
+def submit_order(): bool:
+    order = {}
+    signature = "0x..."
+    data = {
+      "order": order,
+      "signature": signature
+    }
+    response = requests.post(API_URL+ "submitOrder/", json=data)
     fetched_orders = response.json()
-    return fetched_orders
+    return fetched_orders.get("success")
 ```
 
 </TabItem>
@@ -212,10 +219,8 @@ async function getOrders(): getOrdersFetch {
 ```python
 import requests
 
-API_URL = "https://orders.catalyst.exchange/getOrders"
-
 def get_orders():
-    response = requests.get(API_URL)
+    response = requests.get(API_URL + "orders/")
     fetched_orders = response.json()
     return fetched_orders
 ```
@@ -268,8 +273,53 @@ async function initiateOrder() {
 </TabItem>
 <TabItem label="Python">
 
-```sh
-pnpm create astro --template starlight
+```python
+from web3 import Web3
+
+rpc_url = ""
+web3 = Web3(Web3.HTTPProvider(eth_node_url))
+
+# Your ABI and signer details
+reactor_abi = "..."
+signer_private_key = "your_private_key_here"
+signer_address = web3.eth.account.from_key(signer_private_key).address
+
+
+def initiate_order():
+    # Get an order
+    orders = get_orders()
+    order = orders['orders'][0]
+
+    # Define the reactor we will call. You can get the reactor address from the order
+    reactor_address = order['order']['settlementContract']
+    reactor = web3.eth.contract(address=reactor_address, abi=reactor_abi)
+
+    # TODO: there needs to be set approvals for the reactorAddress for all inputs & collateral.
+    # This will depend on the specific ERC20 tokens you're using, you need to call approve() on the ERC20 token contracts
+
+    # Clean the order data by removing the type field
+    cleaned_order_data = order['order']['orderData'].copy()
+    cleaned_order_data.pop('type')
+    cleaned_order = {**order['order'], 'orderData': cleaned_order_data}
+    signature = order['signature']
+    filler_data = "0x" # We will touch on the later.
+
+    # Build the transaction
+    txn = reactor.functions.initiate(cleaned_order, signature, filler_data).build_transaction({
+        'from': signer_address,
+        'nonce': web3.eth.get_transaction_count(signer_address)
+    })
+
+    # Sign the transaction
+    signed_txn = web3.eth.account.sign_transaction(txn, private_key=signer_private_key)
+
+    # Send the transaction
+    tx_hash = web3.eth.send_raw_transaction(signed_txn.rawTransaction)
+
+    # Wait for the transaction receipt
+    receipt = web3.eth.wait_for_transaction_receipt(tx_hash)
+
+    return receipt
 ```
 
 </TabItem>