wayfinder-paths 0.1.22__py3-none-any.whl → 0.1.24__py3-none-any.whl

wayfinder_paths/adapters/brap_adapter/examples.json

@@ -1,55 +1,5 @@
 {
-  "get_swap_quote": {
-    "description": "Get a quote for a cross-chain swap operation",
-    "input": {
-      "from_token_address": "0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
-      "to_token_address": "0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
-      "from_chain_id": 8453,
-      "to_chain_id": 1,
-      "from_address": "0x1234567890123456789012345678901234567890",
-      "to_address": "0x1234567890123456789012345678901234567890",
-      "amount": "1000000000000000000",
-      "slippage": 0.01
-    },
-    "output": {
-      "success": true,
-      "data": {
-        "quotes": [
-          {
-            "provider": "enso",
-            "input_amount": 1000000000000000000,
-            "output_amount": 995000000000000000,
-            "fee_estimate": {
-              "fee_total_usd": 0.08,
-              "fee_breakdown": []
-            },
-            "calldata": {
-              "data": "0x",
-              "to": "0x",
-              "value": "0",
-              "chainId": 8453
-            }
-          }
-        ],
-        "best_quote": {
-          "provider": "enso",
-          "input_amount": 1000000000000000000,
-          "output_amount": 995000000000000000,
-          "fee_estimate": {
-            "fee_total_usd": 0.08,
-            "fee_breakdown": []
-          },
-          "calldata": {
-            "data": "0x",
-            "to": "0x",
-            "value": "0",
-            "chainId": 8453
-          }
-        }
-      }
-    }
-  },
-  "get_best_quote": {
+  "best_quote": {
     "description": "Get the best available quote for a swap operation",
     "input": {
       "from_token_address": "0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
@@ -57,9 +7,7 @@
       "from_chain_id": 8453,
       "to_chain_id": 1,
       "from_address": "0x1234567890123456789012345678901234567890",
-      "to_address": "0x1234567890123456789012345678901234567890",
-      "amount": "1000000000000000000",
-      "slippage": 0.01
+      "amount": "1000000000000000000"
     },
     "output": {
       "success": true,
@@ -80,106 +28,39 @@
       }
     }
   },
-  "calculate_swap_fees": {
-    "description": "Calculate fees for a swap operation",
+  "swap_from_token_ids": {
+    "description": "Execute a swap using token IDs",
     "input": {
-      "from_token_address": "0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
-      "to_token_address": "0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
-      "from_chain_id": 8453,
-      "to_chain_id": 1,
-      "amount": "1000000000000000000",
-      "slippage": 0.01
-    },
-    "output": {
-      "success": true,
-      "data": {
-        "input_amount": 1000000000000000000,
-        "output_amount": 995000000000000000,
-        "gas_fee": 567840,
-        "bridge_fee": 0,
-        "protocol_fee": 0.08,
-        "total_fee": 0.08,
-        "slippage": 0,
-        "price_impact": 6888
-      }
-    }
-  },
-  "compare_routes": {
-    "description": "Compare multiple routes for a swap operation",
-    "input": {
-      "from_token_address": "0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
-      "to_token_address": "0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
-      "from_chain_id": 8453,
-      "to_chain_id": 1,
+      "from_token_id": "usd-coin-base",
+      "to_token_id": "ethereum",
+      "from_address": "0x1234567890123456789012345678901234567890",
       "amount": "1000000000000000000",
-      "slippage": 0.01
+      "strategy_name": "my_strategy"
     },
     "output": {
       "success": true,
       "data": {
-        "total_routes": 2,
-        "best_route": {
-          "provider": "enso",
-          "output_amount": 995000000000000000,
-          "fee_estimate": { "fee_total_usd": 0.08, "fee_breakdown": [] }
-        },
-        "all_routes": [
-          {
-            "provider": "enso",
-            "output_amount": 995000000000000000,
-            "fee_estimate": { "fee_total_usd": 0.08, "fee_breakdown": [] }
-          },
-          {
-            "provider": "enso",
-            "output_amount": 992000000000000000,
-            "fee_estimate": { "fee_total_usd": 0.12, "fee_breakdown": [] }
-          }
-        ],
-        "route_analysis": {
-          "highest_output": {
-            "output_amount": 995000000000000000
-          },
-          "lowest_fees": {
-            "fee_estimate": { "fee_total_usd": 0.08, "fee_breakdown": [] }
-          }
-        }
+        "from_amount": "1000000000000000000",
+        "to_amount": "995000000000000000",
+        "tx_hash": "0xabc123..."
       }
     }
   },
-  "estimate_gas_cost": {
-    "description": "Estimate gas costs for a cross-chain operation",
+  "swap_from_quote": {
+    "description": "Execute a swap from a pre-fetched quote",
     "input": {
-      "from_chain_id": 8453,
-      "to_chain_id": 1,
-      "operation_type": "swap"
-    },
-    "output": {
-      "success": true,
-      "data": {
-        "from_chain": "base",
-        "to_chain": "ethereum",
-        "from_gas_estimate": 100000,
-        "to_gas_estimate": 150000,
-        "total_operations": 2,
-        "operation_type": "swap"
-      }
-    }
-  },
-  "validate_swap_parameters": {
-    "description": "Validate swap parameters before executing",
-    "input": {
-      "from_token_address": "0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
-      "to_token_address": "0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
-      "from_chain_id": 8453,
-      "to_chain_id": 1,
-      "amount": "1000000000000000000"
+      "from_token": {"address": "0x...", "chain": {"id": 8453}},
+      "to_token": {"address": "0x...", "chain": {"id": 1}},
+      "from_address": "0x1234567890123456789012345678901234567890",
+      "quote": {"calldata": {"data": "0x...", "to": "0x..."}, "input_amount": "1000000000000000000"},
+      "strategy_name": "my_strategy"
     },
     "output": {
       "success": true,
       "data": {
-        "valid": true,
-        "quote_available": true,
-        "estimated_output": "995000000000000000"
+        "from_amount": "1000000000000000000",
+        "to_amount": "995000000000000000",
+        "tx_hash": "0xabc123..."
       }
     }
   }

wayfinder_paths/adapters/brap_adapter/manifest.yaml

@@ -0,0 +1,9 @@
+schema_version: "0.1"
+entrypoint: "adapters.brap_adapter.adapter.BRAPAdapter"
+capabilities:
+  - "swap.quote"
+  - "swap.execute"
+  - "swap.compare_routes"
+  - "bridge.quote"
+  - "gas.estimate"
+dependencies: []

wayfinder_paths/adapters/brap_adapter/test_adapter.py

@@ -18,63 +18,7 @@ class TestBRAPAdapter:
         return adapter
 
     @pytest.mark.asyncio
-    async def test_get_swap_quote_success(self, adapter, mock_brap_client):
-        mock_response = {
-            "quotes": [
-                {
-                    "provider": "enso",
-                    "input_amount": 1000000000000000000,
-                    "output_amount": 995000000000000000,
-                    "calldata": {
-                        "data": "0x",
-                        "to": "0x",
-                        "from_address": "0x",
-                        "value": "0",
-                        "chainId": 8453,
-                    },
-                    "fee_estimate": {"fee_total_usd": 0.008, "fee_breakdown": []},
-                }
-            ],
-            "best_quote": {
-                "provider": "enso",
-                "input_amount": 1000000000000000000,
-                "output_amount": 995000000000000000,
-                "calldata": {
-                    "data": "0x",
-                    "to": "0x",
-                    "from_address": "0x",
-                    "value": "0",
-                    "chainId": 8453,
-                },
-                "fee_estimate": {"fee_total_usd": 0.008, "fee_breakdown": []},
-            },
-        }
-        mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
-
-        success, data = await adapter.get_swap_quote(
-            from_token_address="0x" + "a" * 40,
-            to_token_address="0x" + "b" * 40,
-            from_chain_id=8453,
-            to_chain_id=1,
-            from_address="0x1234567890123456789012345678901234567890",
-            to_address="0x1234567890123456789012345678901234567890",
-            amount="1000000000000000000",
-            slippage=0.01,
-        )
-
-        assert success
-        assert data == mock_response
-        mock_brap_client.get_quote.assert_called_once_with(
-            from_token="0x" + "a" * 40,
-            to_token="0x" + "b" * 40,
-            from_chain=8453,
-            to_chain=1,
-            from_wallet="0x1234567890123456789012345678901234567890",
-            from_amount="1000000000000000000",
-        )
-
-    @pytest.mark.asyncio
-    async def test_get_best_quote_success(self, adapter, mock_brap_client):
+    async def test_best_quote_success(self, adapter, mock_brap_client):
         mock_response = {
             "quotes": [],
             "best_quote": {
@@ -93,13 +37,12 @@ class TestBRAPAdapter:
         }
         mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
 
-        success, data = await adapter.get_best_quote(
+        success, data = await adapter.best_quote(
             from_token_address="0x" + "a" * 40,
             to_token_address="0x" + "b" * 40,
             from_chain_id=8453,
             to_chain_id=1,
             from_address="0x1234567890123456789012345678901234567890",
-            to_address="0x1234567890123456789012345678901234567890",
             amount="1000000000000000000",
         )
 
@@ -108,17 +51,16 @@ class TestBRAPAdapter:
         assert data["output_amount"] == 995000000000000000
 
     @pytest.mark.asyncio
-    async def test_get_best_quote_no_quotes(self, adapter, mock_brap_client):
+    async def test_best_quote_no_quotes(self, adapter, mock_brap_client):
         mock_response = {"quotes": [], "best_quote": None}
         mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
 
-        success, data = await adapter.get_best_quote(
+        success, data = await adapter.best_quote(
             from_token_address="0x" + "a" * 40,
             to_token_address="0x" + "b" * 40,
             from_chain_id=8453,
             to_chain_id=1,
             from_address="0x1234567890123456789012345678901234567890",
-            to_address="0x1234567890123456789012345678901234567890",
             amount="1000000000000000000",
         )
 
@@ -126,185 +68,15 @@ class TestBRAPAdapter:
         assert "No quotes available" in data
 
     @pytest.mark.asyncio
-    async def test_calculate_swap_fees_success(self, adapter, mock_brap_client):
-        mock_quote_response = {
-            "quotes": [],
-            "best_quote": {
-                "provider": "enso",
-                "input_amount": 1000000000000000000,
-                "output_amount": 995000000000000000,
-                "gas_estimate": 5000000000000000,
-                "quote": {"priceImpact": 5},
-                "fee_estimate": {
-                    "fee_total_usd": 0.008,
-                    "fee_breakdown": [],
-                },
-                "calldata": {
-                    "data": "0x",
-                    "to": "0x",
-                    "from_address": "0x",
-                    "value": "0",
-                    "chainId": 8453,
-                },
-            },
-        }
-        mock_brap_client.get_quote = AsyncMock(return_value=mock_quote_response)
-
-        success, data = await adapter.calculate_swap_fees(
-            from_token_address="0x" + "a" * 40,
-            to_token_address="0x" + "b" * 40,
-            from_chain_id=8453,
-            to_chain_id=1,
-            amount="1000000000000000000",
-            slippage=0.01,
-        )
-
-        assert success
-        assert data["input_amount"] == 1000000000000000000
-        assert data["output_amount"] == 995000000000000000
-        assert data["gas_fee"] == 5000000000000000
-        assert data["total_fee"] == 0.008
-
-    @pytest.mark.asyncio
-    async def test_compare_routes_success(self, adapter, mock_brap_client):
-        mock_response = {
-            "quotes": [
-                {
-                    "provider": "enso",
-                    "output_amount": 995000000000000000,
-                    "fee_estimate": {"fee_total_usd": 0.008, "fee_breakdown": []},
-                    "calldata": {
-                        "data": "0x",
-                        "to": "0x",
-                        "from_address": "0x",
-                        "value": "0",
-                        "chainId": 8453,
-                    },
-                },
-                {
-                    "provider": "enso",
-                    "output_amount": 992000000000000000,
-                    "fee_estimate": {"fee_total_usd": 0.012, "fee_breakdown": []},
-                    "calldata": {
-                        "data": "0x",
-                        "to": "0x",
-                        "from_address": "0x",
-                        "value": "0",
-                        "chainId": 8453,
-                    },
-                },
-            ],
-            "best_quote": {
-                "provider": "enso",
-                "output_amount": 995000000000000000,
-                "fee_estimate": {"fee_total_usd": 0.008, "fee_breakdown": []},
-                "calldata": {
-                    "data": "0x",
-                    "to": "0x",
-                    "from_address": "0x",
-                    "value": "0",
-                    "chainId": 8453,
-                },
-            },
-        }
-        mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
-
-        success, data = await adapter.compare_routes(
-            from_token_address="0x" + "a" * 40,
-            to_token_address="0x" + "b" * 40,
-            from_chain_id=8453,
-            to_chain_id=1,
-            amount="1000000000000000000",
-        )
-
-        assert success
-        assert data["total_routes"] == 2
-        assert len(data["all_routes"]) == 2
-        assert data["best_route"]["output_amount"] == 995000000000000000
-
-    @pytest.mark.asyncio
-    async def test_estimate_gas_cost_success(self, adapter):
-        success, data = await adapter.estimate_gas_cost(
-            from_chain_id=8453, to_chain_id=1, operation_type="swap"
-        )
-
-        assert success
-        assert data["from_chain"] == "base"
-        assert data["to_chain"] == "ethereum"
-        assert data["from_gas_estimate"] == 100000
-        assert data["to_gas_estimate"] == 150000
-        assert data["total_operations"] == 2
-
-    @pytest.mark.asyncio
-    async def test_validate_swap_parameters_success(self, adapter, mock_brap_client):
-        mock_quote_response = {
-            "quotes": [],
-            "best_quote": {
-                "output_amount": 995000000000000000,
-                "calldata": {
-                    "data": "0x",
-                    "to": "0x",
-                    "from_address": "0x",
-                    "value": "0",
-                    "chainId": 8453,
-                },
-                "fee_estimate": {"fee_total_usd": 0.008, "fee_breakdown": []},
-            },
-        }
-        mock_brap_client.get_quote = AsyncMock(return_value=mock_quote_response)
-
-        success, data = await adapter.validate_swap_parameters(
-            from_token_address="0x" + "a" * 40,
-            to_token_address="0x" + "b" * 40,
-            from_chain_id=8453,
-            to_chain_id=1,
-            amount="1000000000000000000",
-        )
-
-        assert success
-        assert data["valid"] is True
-        assert data["quote_available"] is True
-        assert data["estimated_output"] == "995000000000000000"
-
-    @pytest.mark.asyncio
-    async def test_validate_swap_parameters_invalid_address(self, adapter):
-        success, data = await adapter.validate_swap_parameters(
-            from_token_address="invalid_address",
-            to_token_address="0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
-            from_chain_id=8453,
-            to_chain_id=1,
-            amount="1000000000000000000",
-        )
-
-        assert success is False
-        assert data["valid"] is False
-        assert "Invalid from_token_address" in data["errors"]
-
-    @pytest.mark.asyncio
-    async def test_validate_swap_parameters_invalid_amount(self, adapter):
-        success, data = await adapter.validate_swap_parameters(
-            from_token_address="0x" + "a" * 40,
-            to_token_address="0x" + "b" * 40,
-            from_chain_id=8453,
-            to_chain_id=1,
-            amount="invalid_amount",
-        )
-
-        assert success is False
-        assert data["valid"] is False
-        assert "Invalid amount format" in data["errors"]
-
-    @pytest.mark.asyncio
-    async def test_get_swap_quote_failure(self, adapter, mock_brap_client):
+    async def test_best_quote_failure(self, adapter, mock_brap_client):
         mock_brap_client.get_quote = AsyncMock(side_effect=Exception("API Error"))
 
-        success, data = await adapter.get_swap_quote(
+        success, data = await adapter.best_quote(
             from_token_address="0x" + "a" * 40,
             to_token_address="0x" + "b" * 40,
             from_chain_id=8453,
             to_chain_id=1,
             from_address="0x1234567890123456789012345678901234567890",
-            to_address="0x1234567890123456789012345678901234567890",
             amount="1000000000000000000",
         )