chore: bump version to 4.0.3, migrate OAuth URL to openapi.longbridge.com

Author: sunli829

CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+# [4.0.3]
+
+## Changed
+
+- Migrate OAuth base URL from `openapi.longbridgeapp.com` to `openapi.longbridge.com`.
+- Migrate CN endpoint URLs from `longportapp.cn` to `longbridge.cn`.
+- Change OAuth token storage path from `~/.longbridge-openapi/` to `~/.longbridge/openapi/`.
+- Update all README docs to use `openapi.longbridge.com` for OAuth registration endpoints.
+- Update proto submodule with latest upstream changes (URL migration in proto comments).
+
 # [4.0.2]
 
 ## Added
@@ -24,7 +34,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Added
 
-- **OAuth 2.0** authentication for all language bindings (Rust, C, C++, Java, Python, Node.js). Use `OAuthBuilder` to run the browser flow; pass the resulting `OAuth` handle to `Config::from_oauth()`. Tokens are persisted under `~/.longbridge-openapi/tokens/<client_id>` and reused; the browser is only opened when no valid token exists.
+- **OAuth 2.0** authentication for all language bindings (Rust, C, C++, Java, Python, Node.js). Use `OAuthBuilder` to run the browser flow; pass the resulting `OAuth` handle to `Config::from_oauth()`. Tokens are persisted under `~/.longbridge/openapi/tokens/<client_id>` and reused; the browser is only opened when no valid token exists.
 
 - **Python — async callbacks:** `AsyncQuoteContext` and `AsyncTradeContext` accept async callbacks for `set_on_quote`, `set_on_depth`, `set_on_brokers`, `set_on_trades`, `set_on_candlestick`, and `set_on_order_changed`. If a callback returns a coroutine, the SDK schedules it on the asyncio loop. Sync callbacks still work as before.
 - **Python — `loop_` parameter:** `AsyncQuoteContext.create()` and `AsyncTradeContext.create()` take an optional `loop_` argument. When using async callbacks, pass `loop_=asyncio.get_running_loop()` so the SDK can schedule coroutines with `asyncio.run_coroutine_threadsafe`. Omit `loop_` when using only sync callbacks.

Cargo.toml

@@ -3,19 +3,19 @@ resolver = "3"
 members = ["rust", "python", "nodejs", "java", "c", "mcp"]
 
 [workspace.package]
-version = "4.0.2"
+version = "4.0.3"
 edition = "2024"
 
 [profile.release]
 lto = true
 
 [workspace.dependencies]
-longbridge-wscli = { path = "rust/crates/wsclient", version = "4.0.2" }
-longbridge-httpcli = { path = "rust/crates/httpclient", version = "4.0.2" }
-longbridge-proto = { path = "rust/crates/proto", version = "4.0.2" }
-longbridge-candlesticks = { path = "rust/crates/candlesticks", version = "4.0.2" }
-longbridge-oauth = { path = "rust/crates/oauth", version = "4.0.2" }
-longbridge = { path = "rust", version = "4.0.2" }
+longbridge-wscli = { path = "rust/crates/wsclient", version = "4.0.3" }
+longbridge-httpcli = { path = "rust/crates/httpclient", version = "4.0.3" }
+longbridge-proto = { path = "rust/crates/proto", version = "4.0.3" }
+longbridge-candlesticks = { path = "rust/crates/candlesticks", version = "4.0.3" }
+longbridge-oauth = { path = "rust/crates/oauth", version = "4.0.3" }
+longbridge = { path = "rust", version = "4.0.3" }
 
 tokio = "1.47.1"
 tokio-tungstenite = "0.27.0"

c/README.md

@@ -39,7 +39,7 @@ First, register an OAuth client to get your `client_id`:
 _bash / macOS / Linux_
 
 ```bash
-curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
+curl -X POST https://openapi.longbridge.com/oauth2/register \
   -H "Content-Type: application/json" \
   -d '{
     "client_name": "My Application",
@@ -51,7 +51,7 @@ curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
 _PowerShell (Windows)_
 
 ```powershell
-Invoke-RestMethod -Method Post -Uri https://openapi.longbridgeapp.com/oauth2/register `
+Invoke-RestMethod -Method Post -Uri https://openapi.longbridge.com/oauth2/register `
   -ContentType "application/json" `
   -Body '{
     "client_name": "My Application",
@@ -75,7 +75,7 @@ Save the `client_id` for use in your application.
 **Step 2: Build OAuth client and create a Config**
 
 `lb_oauth_new` loads a cached token from
-`~/.longbridge-openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge-openapi\tokens\<client_id>` on Windows)
+`~/.longbridge/openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge\openapi\tokens\<client_id>` on Windows)
 if one exists and is still valid, or starts the browser authorization flow
 automatically.  The token is persisted to the same path after a successful
 authorization or refresh.  The resulting `lb_oauth_t*` handle is passed
@@ -135,14 +135,14 @@ setx LONGBRIDGE_ACCESS_TOKEN "Access Token get from user center"
 
 ### Other environment variables
 
-| Name                           | Description                                                                      |
-|--------------------------------|----------------------------------------------------------------------------------|
-| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                    |
-| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                    |
-| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`)  |
-| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`)  |
-| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                     |
-| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                  |
+| Name                             | Description                                                                     |
+|----------------------------------|---------------------------------------------------------------------------------|
+| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                   |
+| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                   |
+| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`) |
+| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`) |
+| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                    |
+| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                 |
 | LONGBRIDGE_PRINT_QUOTE_PACKAGES  | Print quote packages when connected, `true` or `false` (Default: `true`)        |
 | LONGBRIDGE_LOG_PATH              | Set the path of the log files (Default: `no logs`)                              |
 

c/csrc/include/longbridge.h

@@ -4226,7 +4226,7 @@ const char *lb_http_result_response_body(const struct lb_http_result_t *http_res
  * Asynchronously build an OAuth 2.0 client.
  *
  * Tries to load an existing token from
- * `~/.longbridge-openapi/tokens/<client_id>`. If the token is missing or
+ * `~/.longbridge/openapi/tokens/<client_id>`. If the token is missing or
  * expired, starts a local callback server and calls `open_url_callback` so
  * the caller can open the authorization URL in a browser.
  *

c/src/oauth.rs

@@ -15,7 +15,7 @@ pub struct COAuth {
 /// Asynchronously build an OAuth 2.0 client.
 ///
 /// Tries to load an existing token from
-/// `~/.longbridge-openapi/tokens/<client_id>`. If the token is missing or
+/// `~/.longbridge/openapi/tokens/<client_id>`. If the token is missing or
 /// expired, starts a local callback server and calls `open_url_callback` so
 /// the caller can open the authorization URL in a browser.
 ///

cpp/README.md

@@ -40,7 +40,7 @@ First, register an OAuth client to get your `client_id`:
 _bash / macOS / Linux_
 
 ```bash
-curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
+curl -X POST https://openapi.longbridge.com/oauth2/register \
   -H "Content-Type: application/json" \
   -d '{
     "client_name": "My Application",
@@ -52,7 +52,7 @@ curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
 _PowerShell (Windows)_
 
 ```powershell
-Invoke-RestMethod -Method Post -Uri https://openapi.longbridgeapp.com/oauth2/register `
+Invoke-RestMethod -Method Post -Uri https://openapi.longbridge.com/oauth2/register `
   -ContentType "application/json" `
   -Body '{
     "client_name": "My Application",
@@ -76,7 +76,7 @@ Save the `client_id` for use in your application.
 **Step 2: Build OAuth client and create a Config**
 
 `OAuthBuilder::build` loads a cached token from
-`~/.longbridge-openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge-openapi\tokens\<client_id>` on Windows)
+`~/.longbridge/openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge\openapi\tokens\<client_id>` on Windows)
 if one exists and is still valid, or starts the browser authorization flow
 automatically.  The token is persisted to the same path after a successful
 authorization or refresh.  The resulting `OAuth` handle is passed directly to
@@ -130,14 +130,14 @@ setx LONGBRIDGE_ACCESS_TOKEN "Access Token get from user center"
 
 ### Other environment variables
 
-| Name                           | Description                                                                      |
-|--------------------------------|----------------------------------------------------------------------------------|
-| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                    |
-| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                    |
-| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`)  |
-| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`)  |
-| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                     |
-| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                  |
+| Name                             | Description                                                                     |
+|----------------------------------|---------------------------------------------------------------------------------|
+| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                   |
+| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                   |
+| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`) |
+| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`) |
+| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                    |
+| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                 |
 | LONGBRIDGE_PRINT_QUOTE_PACKAGES  | Print quote packages when connected, `true` or `false` (Default: `true`)        |
 | LONGBRIDGE_LOG_PATH              | Set the path of the log files (Default: `no logs`)                              |
 

cpp/include/oauth.hpp

@@ -34,7 +34,7 @@ class OAuth
 /// Builder for constructing an OAuth 2.0 client
 ///
 /// Tries to load an existing token from
-/// `~/.longbridge-openapi/tokens/<client_id>`. If the token is missing or
+/// `~/.longbridge/openapi/tokens/<client_id>`. If the token is missing or
 /// expired, starts a local callback server and calls `open_url` so the caller
 /// can open the authorization URL in a browser.
 class OAuthBuilder

examples/rust/subscribe_quote/src/main.rs

@@ -13,7 +13,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
         .with_env_filter(EnvFilter::from_default_env())
         .init();
 
-    let oauth = OAuthBuilder::new("your-client-id")
+    let oauth = OAuthBuilder::new("691c5ae5-a6d2-4d6b-a680-da27cb219226")
         .build(|url| println!("Open this URL to authorize: {url}"))
         .await?;
     let config = Arc::new(Config::from_oauth(oauth));

examples/rust/today_orders/src/main.rs

@@ -9,7 +9,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
         .with_env_filter(EnvFilter::from_default_env())
         .init();
 
-    let oauth = OAuthBuilder::new("your-client-id")
+    let oauth = OAuthBuilder::new("691c5ae5-a6d2-4d6b-a680-da27cb219226")
         .build(|url| println!("Open this URL to authorize: {url}"))
         .await?;
     let config = Arc::new(Config::from_oauth(oauth));

java/README.md

@@ -48,7 +48,7 @@ First, register an OAuth client to get your `client_id`:
 _bash / macOS / Linux_
 
 ```bash
-curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
+curl -X POST https://openapi.longbridge.com/oauth2/register \
   -H "Content-Type: application/json" \
   -d '{
     "client_name": "My Application",
@@ -60,7 +60,7 @@ curl -X POST https://openapi.longbridgeapp.com/oauth2/register \
 _PowerShell (Windows)_
 
 ```powershell
-Invoke-RestMethod -Method Post -Uri https://openapi.longbridgeapp.com/oauth2/register `
+Invoke-RestMethod -Method Post -Uri https://openapi.longbridge.com/oauth2/register `
   -ContentType "application/json" `
   -Body '{
     "client_name": "My Application",
@@ -84,7 +84,7 @@ Save the `client_id` for use in your application.
 **Step 2: Build OAuth client and create a Config**
 
 `OAuthBuilder.build` loads a cached token from
-`~/.longbridge-openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge-openapi\tokens\<client_id>` on Windows)
+`~/.longbridge/openapi/tokens/<client_id>` (`%USERPROFILE%\.longbridge\openapi\tokens\<client_id>` on Windows)
 if one exists and is still valid, or starts the browser authorization flow
 automatically.  The token is persisted to the same path after a successful
 authorization or refresh.  The resulting `OAuth` handle is passed directly to
@@ -125,14 +125,14 @@ setx LONGBRIDGE_ACCESS_TOKEN "Access Token get from user center"
 
 ### Other environment variables
 
-| Name                           | Description                                                                      |
-|--------------------------------|----------------------------------------------------------------------------------|
-| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                    |
-| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                    |
-| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`)  |
-| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`)  |
-| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                     |
-| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                  |
+| Name                             | Description                                                                     |
+|----------------------------------|---------------------------------------------------------------------------------|
+| LONGBRIDGE_LANGUAGE              | Language identifier, `zh-CN`, `zh-HK` or `en` (Default: `en`)                   |
+| LONGBRIDGE_HTTP_URL              | HTTP endpoint url (Default: `https://openapi.longbridge.com`)                   |
+| LONGBRIDGE_QUOTE_WS_URL          | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`) |
+| LONGBRIDGE_TRADE_WS_URL          | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`) |
+| LONGBRIDGE_ENABLE_OVERNIGHT      | Enable overnight quote, `true` or `false` (Default: `false`)                    |
+| LONGBRIDGE_PUSH_CANDLESTICK_MODE | `realtime` or `confirmed` (Default: `realtime`)                                 |
 | LONGBRIDGE_PRINT_QUOTE_PACKAGES  | Print quote packages when connected, `true` or `false` (Default: `true`)        |
 | LONGBRIDGE_LOG_PATH              | Set the path of the log files (Default: `no logs`)                              |