https://github.com/nxtrace/powclient
https://github.com/nxtrace/powclient
nexttrace pow
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/nxtrace/powclient
- Owner: nxtrace
- License: gpl-3.0
- Created: 2023-06-01T06:25:08.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-10-18T17:00:45.000Z (9 months ago)
- Last Synced: 2025-10-19T10:26:54.327Z (9 months ago)
- Topics: nexttrace, pow
- Language: Go
- Homepage:
- Size: 50.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# POW CLIENT
NEXTTRACE项目派生的仓库，用于实现POW反爬
client : https://github.com/tsosunchia/powclient
server : https://github.com/tsosunchia/powserver
## 导出类型与函数
```go
// 获取 token 的主入口。
// 成功返回 (token, nil)；失败返回 ("", err)。
func RetToken(p *GetTokenParams) (string, error)
// 参数：
type GetTokenParams struct {
TimeoutSec time.Duration // 当 > 0 时覆盖整个取 token 流程：获取 challenge、本地求解、提交 answer
BaseUrl string // 例如 "https://example.com"
RequestPath string // 例如 "/request_challenge"
SubmitPath string // 例如 "/submit_answer"
UserAgent string
SNI string // 可选：自定义 TLS SNI；不填则用默认的主机名
Host string // 可选：仅当非空时设置 req.Host
Proxy *url.URL // 可选：socks5:// 或 http://。不设置时默认走环境代理
}
func NewGetTokenParams() *GetTokenParams // 提供一份可用的默认值
```
## 错误模型（可用于精细化处理）
```go
var (
ErrTooManyRequests = errors.New("too many requests") // 429
ErrEmptyToken = errors.New("empty token from server") // 200 但 token 为空
ErrInvalidChallenge = errors.New("invalid challenge integer") // challenge 非法、不可分解或不满足“恰好两个质因子”
)
type HTTPStatusError struct {
Code int // HTTP 状态码（非 200 且非 429）
Body string // 响应体前 2KB 片段（用于排错）
}
```
- 发生 429：返回 ErrTooManyRequests（可做重试/退避）
- 发生其它非 200：返回 *HTTPStatusError（可通过 errors.As 拿到 Code/Body）
- 发生 200 但 token 为空：返回 ErrEmptyToken
- challenge 非法、不可分解、不是恰好两个质因子：返回 ErrInvalidChallenge（包含上下文）
## DEMO
```go
package main
import (
"errors"
"fmt"
"log"
"time"
"github.com/tsosunchia/powclient"
)
func main() {
p := powclient.NewGetTokenParams()
p.BaseUrl = "https://pow.example.com"
p.TimeoutSec = 5 * time.Second
token, err := powclient.RetToken(p)
if err != nil {
// 统一错误处理
if errors.Is(err, powclient.ErrTooManyRequests) {
log.Println("rate limited, please retry later")
return
}
var he *powclient.HTTPStatusError
if errors.As(err, &he) {
log.Printf("http error: code=%d body=%q\n", he.Code, he.Body)
return
}
log.Printf("get token failed: %v\n", err)
return
}
fmt.Println("token:", token)
}
```