bitsealws

package

v0.2.0 Latest Latest Go to latest Published: Jul 6, 2025 License: MIT Imports: 22 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/spycat55/BitSeal_Protocol

Links

Open Source Insights

Documentation ¶

Index ¶

func BuildHandshakeRequest(clientPriv *ec.PrivateKey, serverPub *ec.PublicKey, salt string, nonce string) (body string, headers map[string]string, err error)
func CreateToken(payload map[string]any, priv *ec.PrivateKey, expSec int64) (string, error)
func VerifyHandshakeRequest(body, method, uriPath string, headers map[string]string, ...) (*ec.PublicKey, string, string, error)
func VerifyToken(token string, pub *ec.PublicKey) (map[string]any, error)
type BitSealWSConn
- func ConnectBitSealWS(clientPriv *ec.PrivateKey, serverPub *ec.PublicKey, wsURL string) (*BitSealWSConn, error)
type Server
- func NewServer(priv *ec.PrivateKey) *Server
- func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func BuildHandshakeRequest ¶

func BuildHandshakeRequest(clientPriv *ec.PrivateKey, serverPub *ec.PublicKey, salt string, nonce string) (body string, headers map[string]string, err error)

BuildHandshakeRequest constructs body+headers like TS side.

func CreateToken ¶

func CreateToken(payload map[string]any, priv *ec.PrivateKey, expSec int64) (string, error)

CreateToken builds payload JSON, adds iat/exp, signs SHA256(payload) with secp256k1 ECDSA. Returns base64url(payload) + "." + base64url(signatureDER)

func VerifyHandshakeRequest ¶

func VerifyHandshakeRequest(body, method, uriPath string, headers map[string]string, serverPriv *ec.PrivateKey) (*ec.PublicKey, string, string, error)

VerifyHandshakeRequest validates and returns client pubkey & salt

func VerifyToken ¶

func VerifyToken(token string, pub *ec.PublicKey) (map[string]any, error)

VerifyToken parses token, verifies signature, returns payload claims.

Types ¶

type BitSealWSConn ¶

type BitSealWSConn struct {
	Conn    *websocket.Conn
	Session *rtc.Session
}

BitSealWSConn 封装了 x/net/websocket.Conn，并在读写时自动进行 BST2 编解码。发送方需先 EncodeRecord，接收方需 DecodeRecord，本结构体内部自动处理。

func ConnectBitSealWS ¶

func ConnectBitSealWS(clientPriv *ec.PrivateKey, serverPub *ec.PublicKey, wsURL string) (*BitSealWSConn, error)

ConnectBitSealWS 完成客户端两步握手并建立 BST2 会话，返回包装后的连接。

HTTP POST /ws/handshake – BitSeal-WEB 签名请求
WebSocket Upgrade /ws/socket – 子协议携带 SimpleToken

wsURL 形如 wss://host/ws/socket

func (*BitSealWSConn) Close ¶

func (c *BitSealWSConn) Close() error

Close 关闭底层 websocket 连接。

func (*BitSealWSConn) Read ¶

func (c *BitSealWSConn) Read() ([]byte, error)

Read 接收并解密下一帧，返回明文。

func (*BitSealWSConn) Write ¶

func (c *BitSealWSConn) Write(plain []byte) error

Write 加密并发送明文数据。

type Server ¶

type Server struct {
	// contains filtered or unexported fields
}

Server bundles server private key and an in-memory map for pending sessions.

func NewServer ¶

func NewServer(priv *ec.PrivateKey) *Server

NewServer creates a new BitSeal-WS server with its own ServeMux.

func (*Server) ServeHTTP ¶

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP implements http.Handler so Server can be passed to http.ListenAndServe.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL