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
Copy file name to clipboardExpand all lines: docs/buyer-side/README.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,13 +22,13 @@ The Boson Protocol dApp is currently deployed to Polygon MATIC network, so you n
22
22
23
23
Browse available products by clicking the Explore Products link in the navigation bar. You can search for keywords in the listing, filter by seller and sort by price or other conditions.
24
24
25
-
25
+
26
26
27
27
### Step 1 - Buying an item by committing to it <ahref="#step-1---buying-an-item-by-committing-to-it"id="step-1---buying-an-item-by-committing-to-it"></a>
28
28
29
29
Once you have found the item you want, you can buy it by clicking on the `Commit` button. Remember this is the first step of the buyer's experience - when committing, you pay for the item by transferring the item price into escrow and in turn receive a redeemable NFT (rNFT) that can later be exchanged for the real-world item it represents.
30
30
31
-
31
+
32
32
33
33
Next, you will see the confirmation screen and options to either view your item (and immediately redeem it if you want) or discover more items.
34
34
@@ -38,7 +38,7 @@ Note that if the item is token-gated, you will need to unlock that gate by ownin
38
38
39
39
If not done before, now is the time to connect your wallet to the dApp. Read the message when connecting and allow your wallet to switch to the correct Polygon network before proceeding.
40
40
41
-
41
+
42
42
43
43
After Commit, you can now simply hold the rNFT and store it as a claim on the physical item, you can transfer it to someone else, perhaps as a gif, or you can trade your rNFT on the secondary market, such as OpenSea.
44
44
@@ -48,34 +48,34 @@ The product listing displays a redemption period during which your rNFT is valid
48
48
49
49
When you are ready to take possession of the physical (or phygital) item, go back to the dApp to redeem your rNFT. The rNFT will be burned in the process.
50
50
51
-
51
+
52
52
53
53
When you click `Redeem`, you will see an overlay detailing the fair exchange policy before you can click `Next` to proceed.
54
54
55
-
55
+
56
56
57
57
> Alternatively, you can `Cancel` the purchase, which means that you will receive the refund, deducted by the potential buyer penalty set by the seller. You can also `Contact seller` directly, through the communication channel that seller prepared, e.g. via an encrypted XMTP chat session.
58
58
59
59
You need to enter your address in order to redeem your purchase. Unlike when you buy something on a Web 2.0 commerce site, your address is not stored in a centralized database. Instead, you are sharing your details only with the seller of the item you have purchased.
60
60
61
-
61
+
62
62
63
63
In order to facilitate sharing your address with the seller, you need to initialize a chat session with XMTP, which is a Web3 communication tool. Click the Initialize button in the overlay and you will be prompted to sign a transaction in your wallet to indicate that you are happy to communicate via XMTP.
64
64
65
-
65
+
66
66
67
67
The next screen is a confirmation screen to ensure you are happy with how you have entered your address and to tell you that you have initialized your chat client.
68
68
69
69
You will again see a warning message that your rNFT will be burned on redemption.
70
70
71
-
71
+
72
72
73
73
Once you are happy with all of this, confirm the transaction in your wallet and the redemption step is complete.
74
74
75
75
Finally, you will be shown the confirmation overlay letting you know that your redemption is complete.
76
76
77
-
77
+
78
78
79
79
You will notice that the item you have purchased now no longer has the Redeem option available. If you need to contact the seller or raise a dispute, you can do so via the item page, which you will find in My Items, with a 'Redeemed' tag showing.
Copy file name to clipboardExpand all lines: docs/seller-side/boson-for-woocommerce.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,7 +41,7 @@ Then, install the Boson extension like so:
41
41
* Go to: `WordPress Admin` > `Plugins` > `Add New` to upload the file you downloaded with `Choose File`.
42
42
* Activate the extension.
43
43
44
-
44
+
45
45
46
46
> Note: If the extension is already installed and you are trying to update it, you will be asked to confirm if you want to replace the installed version with the new one found in the uploaded .zip file. In that case, proceed.
47
47
@@ -53,19 +53,19 @@ After activating the plugin, we need to link the account used on Boson Protocol.
53
53
54
54
(1) Go to: `WooCommerce` > `Boson for WooCommerce`. (2) Select `Connect Account` if you already have a Boson seller profile, otherwise, click on `Create Account` to create one.
(4) You'll see the connected wallet address, and the plugin will check the validity of your seller account with Boson Protocol on-chain. Click `Proceed` if the displayed wallet address is as expected, or connect a different wallet and repeat the above step.
(5) Clicking `Proceed` will prompt you to sign a message through your Web3 client. This message will be used to secure the integration of the Boson Redemption Widget to the particular domain of your website.
(6) Once your connected wallet address is identified as a registered Boson seller, the extension is ready for use!
71
71
@@ -77,7 +77,7 @@ The Redemption page is where your customers will be able to redeem their rNFTs t
77
77
78
78
This is the page that should include the block (or shortcode) offered by the extension for rendering the Boson Redemption Widget. Your customers will be able to connect their wallet and redeem their rNFTs through that page or even raise disputes for their already redeemed rNFTs. The extension offers an option to create a very basic redemption page for you by clicking the `Create Redemption Page` button, which you will be able to customize if you wish to!
The extension offers two blocks to render the redemption widget:
83
83
@@ -104,14 +104,14 @@ Once the Redemption page is created, you will also be able to find it under the
104
104
105
105
You can specify the shipping method that will be used for all Boson orders. The shipping method, regardless of its registered cost, will be attached to the order at 0 cost for the customer. Third party integration with shipping (if applicable), will be able to pick up the registered shipping method from each Boson order.
### Synchronizing data <ahref="#synchronizing-data"id="synchronizing-data"></a>
110
110
111
111
Once the seller's Boson profile is linked to WooCommerce, the data will start synchronizing between Boson Protocol and Boson for WooCommerce plugin.
112
112
113
113
The data that is synchronized includes products, buyer redemptions and any potential disputes raised. The sync task runs every 30 minutes, but can also be run manually on demand.
> Note: If the buyer redeems an rNFT outside the WooCommerce plugin, a warning is displayed that this order should be managed elsewhere, i.e. via the Boson dApp. This is needed because the delivery information and other buyer-seller communication must have happened outsite Boson for WooCommerce plugin, so the plugin has no way of accessing that data.
Copy file name to clipboardExpand all lines: docs/seller-side/selling-on-the-dapp/creating-a-product.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ nav_order: 4
9
9
10
10
### The first decentralized marketplace built on Boson Protocol allows you to tokenize, trade or transfer any physical item as an NFT <ahref="#the-first-decentralized-marketplace-built-on-boson-protocol-allows-you-to-tokenize-trade-or-transfer"id="the-first-decentralized-marketplace-built-on-boson-protocol-allows-you-to-tokenize-trade-or-transfer"></a>
11
11
12
-
12
+
13
13
14
14
In this tutorial you will learn how to create a product and offer it for sale on the Boson decentralized application (dApp).
15
15
@@ -23,13 +23,13 @@ By now, you should have already created a seller profile and have the wallet con
23
23
24
24
To continue, click on the `Create Products` button at the top right.
#### Select the product type <ahref="#select-the-product-type"id="select-the-product-type"></a>
29
29
30
30
You will be presented to choose the type and variants of the product. The column to the right provides explanation of various options and their meaning.
Click `Next` when you are ready to move on. For simplicity, we'll now asume that we selected a Physical and One item type.
35
35
@@ -39,7 +39,7 @@ Describe the product to buyers using the title and description fields.
39
39
40
40
Tell them about its unique features, or why you are selling it. The goal is to tell them why they might want to buy it. As with selling on any other marketplace, you should aim to provide clear, factual information about the product, for example, the fabric composition or - if you are listing a vintage collectible - the exact condition of the item.
Categories will be helpful to focus search results, so it’s best to select an existing category if appropriate. If it is truly unique, you can create your own category by filling in the "other" category field. Select a category using the dropdown menu.
45
45
@@ -53,7 +53,7 @@ Optionally, you can provide additional information about the product that is com
53
53
54
54
Larger-scale merchants who have multiple items for sale will find this section invaluable for entering inventory information and other identifiers for products.
### Core Terms of Sale <ahref="#core-terms-of-sale"id="core-terms-of-sale"></a>
71
71
@@ -77,7 +77,7 @@ Offer validity period is the interval during which purchasing the product's rNFT
77
77
78
78
The redemption period is the time during which the buyer can trade their rNFT. Generally, the longer the redemption period, the better, as this means the buyer will be able to benefit from the option to trade it on secondary markets. However, only make this period as long as you are able to deliver the underlying product.
79
79
80
-
80
+
You may optionally wish to add values for parcel measurements and weight, as well as a url to the redemption point (this is set by default to the Boson dApp).
Copy file name to clipboardExpand all lines: docs/seller-side/selling-on-the-dapp/profile-creation.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ nav_order: 2
11
11
12
12
The first thing to be done for selling on the Boson marketplace dApp is creating an account - and if you have a Lens profile, you can use it, too! Simply click on `Sell on Boson` button to get started.
13
13
14
-
14
+
15
15
16
16
#### What is a Lens profile and what are its benefits? <ahref="#what-is-a-lens-profile-and-what-are-its-benefits"id="what-is-a-lens-profile-and-what-are-its-benefits"></a>
17
17
@@ -39,10 +39,10 @@ You can optionally specify the percentage amount for secondary royalties that yo
39
39
40
40
Note that royalties percentage cannot be changed later.
As a final step, you have an option to check all the data and finally to confirm it by clicking on `Create Seller Account`. This invokes a signature request in your wallet which you need to confirm to proceed.
First of all, name your store. The first field should contain the name that is shown in the browser tab when people navigate to your store. This can be the same as, or different from, the Title, which is the headline displayed on your storefront.
29
29
@@ -49,7 +49,7 @@ Once you hit `Create`, your very own store is ready!
49
49
50
50
You will be presented with further options to make it friendlier.
You will receive an IPFS link to your storefront (example, “[https://bosonprotocol.infura-ipfs.io/ipfs/QmQcbJVmZSM4MGuBZBexRUVM1TdwBX4hfWzoHJwPFhNK3E](https://bosonprotocol.infura-ipfs.io/ipfs/QmQcbJVmZSM4MGuBZBexRUVM1TdwBX4hfWzoHJwPFhNK3E)…”). We recommend that you have an ENS domain ready to hide that IPFS link behind a friendlier name. You could even create a subdomain from your current ENS (example, store.myname.eth).
On the product detail page, more information about the gate is presented, such as the amount of tokens needed and the address of the token contract. If the buyer doesn't have the required token balance and/or ID to unlock the product, purchasing is not possible and this is actually enforced on-chain!
0 commit comments