diff --git a/bip-0040.mediawiki b/bip-0040.mediawiki index 37525ea001..0acd3be426 100644 --- a/bip-0040.mediawiki +++ b/bip-0040.mediawiki @@ -73,7 +73,7 @@ It could be possible that a request or response also has a Content-MD5STRATUM_SESSION is used. If a client sends a request with a cookie, the servers knows exactly which session is used and which notifications to send. -Servers could send the Stratum-Session-Timeout header to tell the client when a session with the same session id will be seen as a new session by the server. The header contains a number that indicates how many seconds are left. This is different from Expires or Max-Age parameters of the Set-Cookie header, that indicate when a cookie (not necessarily a session) should have been expired by the client. For backwards compatibility, a X-Session-Timeout header with the same value should be sent in those requests too. +Servers could send the Stratum-Session-Timeout header to tell the client when a session with the same session id will be seen as a new session by the server. The header contains a number that indicates how many seconds are left. This is different from Expires or Max-Age parameters of the Set-Cookie header, that indicate when a cookie (not necessarily a session) should have been expired by the client. For backwards compatibility, a X-Session-Timeout header with the same value should be sent in those requests too. ====HTTP Poll==== @@ -83,9 +83,9 @@ If no error occurred, the server will respond with a 200 status code and with Stratum-Callback-URL header. This will let the server send notifications using the callback URL without the client needing to send HTTP poll requests in with a very small interval. To disable HTTP Push mode, a regular HTTP poll request should be sent with an additional empty Stratum-Callback-URL header. For backwards compatibility, a X-Callback-URL header with the same value should be sent in those requests too. +HTTP Poll is the default mode when connecting with a server over HTTP. To get the session in HTTP Push mode, a client should send a regular HTTP Poll request with an additional Stratum-Callback-URL header. This will let the server send notifications using the callback URL without the client needing to send HTTP poll requests in with a very small interval. To disable HTTP Push mode, a regular HTTP poll request should be sent with an additional empty Stratum-Callback-URL header. For backwards compatibility, a X-Callback-URL header with the same value should be sent in those requests too. -The callback URL will be called when there are notifications. This request is an HTTP POST request with a Content-Type header and a Stratum-Session-ID header. The Stratum-Session-ID contains the same id as the STRATUM_SESSION cookie. This makes it possible to use the callback URL for multiple sessions. The response is of the callback URL is expected to be empty, so any response body will likely be ignored. For backwards compatibility, a X-Session-ID header with the same value should be sent in those requests too. +The callback URL will be called when there are notifications. This request is an HTTP POST request with a Content-Type header and a Stratum-Session-ID header. The Stratum-Session-ID contains the same id as the STRATUM_SESSION cookie. This makes it possible to use the callback URL for multiple sessions. The response is of the callback URL is expected to be empty, so any response body will likely be ignored. For backwards compatibility, a X-Session-ID header with the same value should be sent in those requests too. ===HTTP over SSL/TLS=== @@ -124,7 +124,43 @@ Stratum over a WebSocket connection with SSL/TLS. Just the same as normal WebSoc ==Specification: Commands== -TODO +===Service: Blockchain Address=== + +* Service name: blockchain.address + +====Method: Get History==== + +* Method name: get_history + +{| +! +! Name +! Value +|- +! Method +| colspan="2" | blockchain.address.get_history +|- +! Param [0] +| +| +|} + +====Method: Subscribe==== + +* Method name: subscribe + +{| +! +! Name +! Value +|- +! Method +| colspan="2" | blockchain.address.subscribe +|- +! Param [0] +| +| +|} ==References== \ No newline at end of file