rene

Repositories

7

Projects Packages Public Activity Starred Repositories

@tip/proxy-agent (1.0.2)

Published 2026-04-10 11:31:51 +00:00 by rene

Installation

Setup this registry in your project .npmrc file:

@tip:registry=

To install the package using npm, run the following command:

npm install @tip/proxy-agent@1.0.2

or add it to the package.json file:

"@tip/proxy-agent": "1.0.2"

For more information on the npm registry, see the documentation.

About this package

@tip/proxy-agent

Contribute bandwidth to the TIP (Transceiver Intelligence Platform) proxy network and get free API access in return.

How it works

• You run the agent on a residential or home server machine
• The agent starts a SOCKS5 proxy server on your machine
• TIP scrapers route through your IP to bypass datacenter IP blocks (e.g. CloudFront WAF)
• You get: free TIP API access, contributor badge, early access to new features

Install & Start

# Option 1: Global install (recommended)
npm install -g @tip/proxy-agent --@tip:registry=https://gitea.context-x.org/api/packages/rene/npm/
tip-agent start --token YOUR_TOKEN

# Option 2: One-line configure + install
echo "@tip:registry=https://gitea.context-x.org/api/packages/rene/npm/" >> ~/.npmrc
npm install -g @tip/proxy-agent
tip-agent start --token YOUR_TOKEN

# Option 3: npx (no install)
npx --@tip:registry=https://gitea.context-x.org/api/packages/rene/npm/ @tip/proxy-agent start --token YOUR_TOKEN

⚠️ Important: Always use --@tip:registry (scoped), NOT --registry.
Using --registry redirects ALL packages (incl. dependencies like dotenv) to Gitea — those are not available there.

Get your token

1. Go to transceiver-db.context-x.org/dashboard
2. Open the Network tab
3. Click Join Network — your token is shown immediately

Options

tip-agent start --token TOKEN [--port 1080] [--max-gb 10] [--name "My Node"]
tip-agent status
tip-agent stop

Option	Default	Description
--token	(required)	Your TIP node token
--port	1080	SOCKS5 listen port
--max-gb	10	Max bandwidth to donate
--name	hostname	Node display name
--server	https://transceiver-db.context-x.org	TIP API server

Protocol

• SOCKS5 (RFC 1928)
• No-auth method
• TCP CONNECT only
• 30s connection timeout
• Heartbeat every 30s to routing server

Privacy

• Only outbound TCP CONNECT requests are proxied (no BIND, no UDP)
• Bandwidth is capped at your configured limit
• No logs of proxied content are stored
• Your IP is visible to the target website (residential proxy model)

Dependencies

Dependencies

ID	Version
dotenv	^16.0.0

Development Dependencies

ID	Version
@types/node	^20.0.0
typescript	^5.0.0

Details

npm

2026-04-10 11:31:51 +00:00

0

118 KiB

Assets (1)

proxy-agent-1.0.2.tgz 118 KiB

Versions (5) View all

1.0.4 2026-04-10

1.0.3 2026-04-10

1.0.2 2026-04-10

1.0.1 2026-04-10

1.0.0 2026-04-04