example reorganization (#164)

mihaimarcu2004 · web-flow · commit da322db2ca4f · 2026-07-28T18:51:18.000+03:00
diff --git a/README.md b/README.md
@@ -42,10 +42,10 @@ if __name__ == "__main__":
 The [`examples/`](examples) directory contains end-to-end scripts for the
 common flows. A few starting points:
 
-- [Read public REST endpoints](examples/get_info.py)
-- [Stream order books and account state over websocket](examples/ws.py)
-- [Create / modify / cancel an order over HTTP](examples/create_modify_cancel_order_http.py)
-- [Create / modify / cancel an order over websocket](examples/create_modify_cancel_order_ws.py)
+- [Read public REST endpoints](examples/market-data/get_info.py)
+- [Stream order books and account state over websocket](examples/websocket/ws.py)
+- [Create / modify / cancel an order over HTTP](examples/orders/create_modify_cancel_order_http.py)
+- [Create / modify / cancel an order over websocket](examples/orders/create_modify_cancel_order_ws.py)
 - [System setup (API key, signer)](examples/system_setup.py)
 
 See [`examples/README.md`](examples/README.md) for the full annotated list.
diff --git a/examples/accounts/sub_account_create.py b/examples/accounts/sub_account_create.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/accounts/sub_account_transfer_eth.py b/examples/accounts/sub_account_transfer_eth.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 TO_ACCOUNT_INDEX = 281474976710648
 
diff --git a/examples/accounts/sub_account_transfer_usdc.py b/examples/accounts/sub_account_transfer_usdc.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 TO_ACCOUNT_INDEX = 281474976710648
 
diff --git a/examples/batch-orders/send_batch_tx_http.py b/examples/batch-orders/send_batch_tx_http.py
@@ -1,6 +1,6 @@
 import asyncio
 import time
-from utils import default_example_setup, trim_exception
+from examples.utils import default_example_setup, trim_exception
 
 
 # this example does the same thing as the send_batch_tx_ws.py example, but sends the TX over HTTP instead of WS
diff --git a/examples/batch-orders/send_batch_tx_ws.py b/examples/batch-orders/send_batch_tx_ws.py
@@ -2,7 +2,7 @@
 import asyncio
 import time
 
-from utils import default_example_setup, ws_send_batch_tx, trim_exception
+from examples.utils import default_example_setup, ws_send_batch_tx, trim_exception
 
 
 # this example does the same thing as the send_batch_tx_http.py example, but sends the TX over WS instead of HTTP
diff --git a/examples/margin/add_eth_margin.py b/examples/margin/add_eth_margin.py
@@ -1,6 +1,6 @@
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def fetch(api_client, idx):
diff --git a/examples/margin/disable_eth_as_margin.py b/examples/margin/disable_eth_as_margin.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/disable_uta.py b/examples/margin/disable_uta.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/enable_eth_as_margin.py b/examples/margin/enable_eth_as_margin.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/enable_uta.py b/examples/margin/enable_uta.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/margin_eth_20x_cross_http.py b/examples/margin/margin_eth_20x_cross_http.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/margin_eth_50x_isolate_ws.py b/examples/margin/margin_eth_50x_isolate_ws.py
@@ -1,6 +1,6 @@
 import websockets
 import asyncio
-from utils import default_example_setup, ws_send_tx
+from examples.utils import default_example_setup, ws_send_tx
 
 
 async def main():
diff --git a/examples/margin/margin_eth_add_collateral_http.py b/examples/margin/margin_eth_add_collateral_http.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/margin/margin_eth_remove_collateral_ws.py b/examples/margin/margin_eth_remove_collateral_ws.py
@@ -1,6 +1,6 @@
 import asyncio
 import websockets
-from utils import default_example_setup, ws_send_tx
+from examples.utils import default_example_setup, ws_send_tx
 
 
 async def main():
diff --git a/examples/market-data/get_info.py b/examples/market-data/get_info.py
diff --git a/examples/market-data/get_set_maker_only_api_keys.py b/examples/market-data/get_set_maker_only_api_keys.py
@@ -1,5 +1,5 @@
 import asyncio, json, lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 async def main():
     client, api_client, _ = default_example_setup()
diff --git a/examples/orders/cancel_all_orders_single_market.py b/examples/orders/cancel_all_orders_single_market.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 # Scope a cancel-all to a single market.
diff --git a/examples/orders/create_grouped_ioc_with_attached_sl_tp.py b/examples/orders/create_grouped_ioc_with_attached_sl_tp.py
@@ -1,6 +1,6 @@
 import asyncio
 from lighter.signer_client import CreateOrderTxReq
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_grouped_ioc_with_integrator.py b/examples/orders/create_grouped_ioc_with_integrator.py
@@ -1,6 +1,6 @@
 import asyncio
 from lighter.signer_client import CreateOrderTxReq
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_grouped_orders_cliend_order_index.py b/examples/orders/create_grouped_orders_cliend_order_index.py
@@ -1,7 +1,7 @@
 import asyncio
 import time
 from lighter.signer_client import CreateOrderTxReq
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 BASE_CID = int(time.time()) % (2 ** 48 - 10)
 
diff --git a/examples/orders/create_market_order_async_client.py b/examples/orders/create_market_order_async_client.py
@@ -1,7 +1,7 @@
 import asyncio
 
 import lighter
-from utils import get_api_key_config, trim_exception
+from examples.utils import get_api_key_config, trim_exception
 
 
 async def create_signer_for_user(config_file="./api_key_config.json"):
diff --git a/examples/orders/create_market_order_eth_buy.py b/examples/orders/create_market_order_eth_buy.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_market_order_eth_sell.py b/examples/orders/create_market_order_eth_sell.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_market_order_max_slippage.py b/examples/orders/create_market_order_max_slippage.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_market_order_quote_amount.py b/examples/orders/create_market_order_quote_amount.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_modify_cancel_order_http.py b/examples/orders/create_modify_cancel_order_http.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_modify_cancel_order_ws.py b/examples/orders/create_modify_cancel_order_ws.py
@@ -1,6 +1,6 @@
 import websockets
 import asyncio
-from utils import default_example_setup, ws_send_tx
+from examples.utils import default_example_setup, ws_send_tx
 
 
 # this example does the same thing as the create_modify_cancel_order.py example, but sends the TX over WS instead of HTTP
diff --git a/examples/orders/create_modify_cancel_skip_nonce.py b/examples/orders/create_modify_cancel_skip_nonce.py
@@ -1,7 +1,7 @@
 import asyncio
 
 from lighter.nonce_manager import NonceManagerType
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_order_skip_nonce.py b/examples/orders/create_order_skip_nonce.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_position_tied_sl_tp.py b/examples/orders/create_position_tied_sl_tp.py
@@ -1,6 +1,6 @@
 import asyncio
 from lighter.signer_client import CreateOrderTxReq
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/create_with_multiple_keys.py b/examples/orders/create_with_multiple_keys.py
@@ -1,6 +1,6 @@
 import time
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/orders/self_trade_create_modify_order.py b/examples/orders/self_trade_create_modify_order.py
@@ -1,6 +1,6 @@
 import asyncio
 import time
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 # Self-trade prevention (STP) on order creation / modification.
diff --git a/examples/orders/self_trade_grouped_orders.py b/examples/orders/self_trade_grouped_orders.py
@@ -1,6 +1,6 @@
 import asyncio
 from lighter.signer_client import CreateOrderTxReq
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 # Self-trade prevention applied to a grouped (OTOCO) order.
diff --git a/examples/paper-trading/paper_trading_health.py b/examples/paper-trading/paper_trading_health.py
diff --git a/examples/paper-trading/paper_trading_live.py b/examples/paper-trading/paper_trading_live.py
diff --git a/examples/paper-trading/paper_trading_snapshot.py b/examples/paper-trading/paper_trading_snapshot.py
diff --git a/examples/public-pool/public_pool_create_modify.py b/examples/public-pool/public_pool_create_modify.py
@@ -2,7 +2,7 @@
 import json
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/public-pool/public_pool_deposit.py b/examples/public-pool/public_pool_deposit.py
@@ -1,6 +1,6 @@
 import asyncio
 
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 POOL_ACCOUNT_INDEX = 281474976710651
 
diff --git a/examples/public-pool/public_pool_info.py b/examples/public-pool/public_pool_info.py
@@ -1,6 +1,6 @@
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 POOL_ACCOUNT_INDEX = 281474976710651
 
diff --git a/examples/public-pool/public_pool_withdraw.py b/examples/public-pool/public_pool_withdraw.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 POOL_ACCOUNT_INDEX = 281474976710651
 
diff --git a/examples/public-pool/stake_and_unstake.py b/examples/public-pool/stake_and_unstake.py
@@ -1,6 +1,6 @@
 import asyncio
 
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 STAKING_POOL_INDEX = 281474976624800
 
diff --git a/examples/spot/spot_get_account_assets_http.py b/examples/spot/spot_get_account_assets_http.py
@@ -1,7 +1,7 @@
 import logging
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 async def main():
diff --git a/examples/spot/spot_get_account_assets_ws.py b/examples/spot/spot_get_account_assets_ws.py
@@ -4,7 +4,7 @@
 import websockets
 
 from lighter.models import WSAccountAssets
-from utils import default_example_setup, ws_subscribe, ws_ping
+from examples.utils import default_example_setup, ws_subscribe, ws_ping
 
 
 async def consume_messages(ws):
diff --git a/examples/spot/spot_get_order_books.py b/examples/spot/spot_get_order_books.py
@@ -2,7 +2,7 @@
 import asyncio
 import lighter
 from lighter import Asset
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 # This example shows how to fetch order books and assets details
 # This information should be enough to be able to trade on Lighter
diff --git a/examples/spot/spot_self_transfer_perp_spot.py b/examples/spot/spot_self_transfer_perp_spot.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 async def main():
     client, api_client, _ = default_example_setup()
diff --git a/examples/spot/spot_self_transfer_spot_perp.py b/examples/spot/spot_self_transfer_spot_perp.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 
 
diff --git a/examples/transfers/transfer.py b/examples/transfers/transfer.py
@@ -1,6 +1,6 @@
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 ETH_PRIVATE_KEY = "1234567812345678123456781234567812345678123456781234567812345678"
 TO_ACCOUNT_INDEX = 9
diff --git a/examples/transfers/transfer_same_master_account.py b/examples/transfers/transfer_same_master_account.py
@@ -1,6 +1,6 @@
 import asyncio
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 TO_ACCOUNT_INDEX = 281474976710648 # same master account
 
diff --git a/examples/transfers/withdraw_fast.py b/examples/transfers/withdraw_fast.py
@@ -1,7 +1,7 @@
 import asyncio
 import json
 import lighter
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 ETH_PRIVATE_KEY = "1234567812345678123456781234567812345678123456781234567812345678"
 WITHDRAW_ADDRESS = "0x0000..."
diff --git a/examples/transfers/withdraw_normal.py b/examples/transfers/withdraw_normal.py
@@ -1,5 +1,5 @@
 import asyncio
-from utils import default_example_setup
+from examples.utils import default_example_setup
 
 AMOUNT = 5.0
 
diff --git a/examples/websocket/ws.py b/examples/websocket/ws.py
diff --git a/examples/websocket/ws_async.py b/examples/websocket/ws_async.py
