You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add Tunnelmole as an open source tunnelling option in addition to ngrok (#219)
* Add Tunnelmole as an open source tunnelling option
* remove curlshell install instructions
---------
Co-authored-by: Jordan Sexton <[email protected]>
Copy file name to clipboardExpand all lines: examples/nft-create/README.md
+29-4Lines changed: 29 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -107,14 +107,39 @@ Both are an identical transaction. The browser wallets tend to have better error
107
107
108
108
### Making localhost:3000 internet accessible
109
109
110
-
When you scan the QR code it encodes the full URL of the checkout API, eg. `http://localhost:3000/api/checkout`. Without fiddling with networking on the phone, this can't be resolved by a mobile wallet.
110
+
To enable your local development environment to be accessed from the internet—for example, to allow a mobile wallet to resolve and connect to your `localhost` server—you can use secure tunneling tools like Tunnelmole or ngrok.
111
111
112
-
One easy way to handle this is to use [ngrok](https://ngrok.com). Once you sign up (free) and download their CLI you can run `ngrok http 3000`.
112
+
#### Using Tunnelmole (Open Source)
113
113
114
-
You'll see an output with a message like:
114
+
[Tunnelmole](https://github.com/robbie-cahill/tunnelmole-client) is an open source tunneling tool that allows you to create a Public URL that forwards traffic to your local machine via a secure tunnel. Once installed, start the Tunnelmole service for the desired local port (e.g., 3000):
115
+
116
+
```
117
+
tmole 3000
118
+
```
119
+
120
+
Tunnelmole will present an output like:
121
+
122
+
```
123
+
http://bvdo5f-ip-49-183-170-144.tunnelmole.net is forwarding to localhost:3000
124
+
https://bvdo5f-ip-49-183-170-144.tunnelmole.net is forwarding to localhost:3000
125
+
```
126
+
127
+
This will provide you with a Public URL that you can use to make your `localhost:3000` accessible from any device. For instance, it will allow a QR code to encode a URL like `https://bvdo5f-ip-49-183-170-144.tunnelmole.net/api/checkout` which will be resolvable by mobile wallets.
128
+
129
+
#### Using ngrok (Closed Source)
130
+
131
+
Alternatively, you can use [ngrok](https://ngrok.com), a popular closed source tunneling tool. After signing up (free) and downloading their CLI, run the following command:
This `ngrok.io` domain will forward to your `localhost:3000` and be accessible anywhere. In other words it'll show the home page, with a QR code that encodes eg. `https://6fba-2a02-c7c-50a3-a200-1402-5c1a-a7d2-174d.eu.ngrok.io/api/checkout`. This will work correctly with mobile wallets!
143
+
This `ngrok.io` domain will forward to your `localhost:3000` and will also be accessible from anywhere. For example, it will make the home page with a QR code that encodes a URL like `https://6fba-2a02-c7c-50a3-a200-1402-5c1a-a7d2-174d.eu.ngrok.io/api/checkout` work correctly with mobile wallets.
144
+
145
+
By using Tunnelmole or ngrok, you can quickly and securely expose your local development server to the internet for testing and sharing with others.
0 commit comments