githubEdit

FAQ

Frequently Asked Questions and Common Misconceptions

circle-info

If your question is not answered below, please consider posting it to the Request Network Discussionsarrow-up-right page on Github.

chevron-rightIs Request Network a blockchain, smart contract platform, or L2 scaling solution?hashtag

No. Request Network is not a blockchain, smart contract platform, or scaling solution. Rather, it's a protocol for storing payment requests, facilitating on-chain payments, and reconciling those payments with the requests. It stores payment requests in IPFSarrow-up-right and CID hashes on Gnosis Chainarrow-up-right. It uses The Grapharrow-up-right for on-chain event indexing. It processes payments across a variety of supported payment chainsarrow-up-right.

chevron-rightWhat is the difference between Request Network and Request Finance?hashtag

Request Network is an open-source protocol. Request Finance is a product built on top of Request Network. Request Finance has spun off from Request Network, and they are now two separate teams.

chevron-rightDo I need to create a request on the same chain that I want to receive payment?hashtag

No. Requests are created on Gnosis Chain (or Sepolia for testing), even if the payment will happen on a different chain. Payment(s) can occur on any of our supported payment chainsarrow-up-right.

To help builders get started quickly, the Request Network Foundation operates Request Node Gatewaysarrow-up-right that are free for anyone to use. These gateways offer endpoints for creating and retrieving requests.

Requests created on Gnosis Chain are "real" and will exist forever. Requests created on Sepolia are "test" requests and will exist only as long as Sepolia continues to operate.

chevron-rightIs the address that creates a request the same address that receives the payment?hashtag

It can be, but not necessarily. The Signer Identity that signs to create a request is defined by the signer parameter. This is separate from the Payment Recipient which is defined by the paymentNetwork.parameters.paymentAddressparameter. They can be the same or different.

This design allows for a single payee identity to have potentially multiple payment recipient addresses.

See Parties of a Request for details.

chevron-rightAre requests in Request Network stored fully on-chain?hashtag

No. Request Network is a hybrid on/off-chain protocol storing the majority of request contents in IPFS. Only the content-addressable ID (CID) is stored on-chain, on Gnosis Chain.

chevron-rightCan I make a payment before creating a request?hashtag

Yes. Payments are linked to requests via a Payment Reference derived from the request contents. Therefore, it is possible to calculate the paymentReference and execute a payment before creating the corresponding request.

chevron-rightDoes Request Network support requests for fiat currency?hashtag

Yes and No.

Requests can be denominated in fiat currencies like USD, EUR, etc. (ISO 4217 currenciesarrow-up-right) but our payment smart contracts only support payments in cryptocurrencies. We call these Conversion Payments, in which the requested fiat amount is converted to the appropriate cryptocurrency amount using on-chain price feeds at the moment of payment.

It is possible to implement fiat payments using Declarative Requests, where the payer declares that the payment was sent and the payee declares that the payment was received.

chevron-rightDoes Request Network support crypto-to-fiat (off-ramp) or fiat-to-crypto (on-ramp) payments?hashtag

Not currently, but we're working on it.

chevron-rightDoes Request Network support crypto payments from centralized exchanges (CEX) or custodians?hashtag
chevron-rightCan a Request Node modify a request's contents before persisting it to IPFS and on-chain?hashtag

No. A Request Node cannot change a request's contents before persisting it to IPFS and on-chain because doing so would invalidate the signature. This is true for private, encrypted requests as well. The Request Node cannot forge the end-user's signature.

chevron-rightCan I create a request via the Request Network SDK without using a Request Node?hashtag

No. Today, a Request Node is required to interact with the Request Network IPFS Network. That said, it is possible to make the end-user pay the protocol fee when creating a request instead of the Request Node. To do this, inject an HttpMetaMaskDataAccess into the frontend RequestNetwork instance.

chevron-rightCan I access a user's historical invoices created via Request Finance?hashtag

Yes. It is possible to request access to a user's Request Finance invoices using the add-stakeholder web componentarrow-up-right which is just a thin wrapper around the Request Finance Add Stakeholders APIarrow-up-right. They display a dialog that prompts the end-user to grant access to 1 invoice at a time.

Details:

  • Request Finance invoices are encrypted.

  • Request Network Foundation cannot grant access to encrypted requests in Request Finance.

chevron-rightDoes Request Network support cross-chain payments where the payer sends funds on one chain and the payee receives funds on a different chain?hashtag

No. Request Network does not currently support cross-chain payments. All of the supported payment types involve the payer sending funds and the payee receiving funds on the same chain.

chevron-rightDoes Request Network support private requests?hashtag
chevron-rightDoes Request Network support private payments?hashtag
chevron-rightCan I create a request via a smart contract call?hashtag

No. It is not currently possible to create a request via a smart contract call. However, RequestNetwork/public-issues#15arrow-up-right is in our roadmap to make this possible.

The recommended way to create a request is using the Request Network API.

chevron-rightCan I use Request Network requests even if I have my own payment infrastructure?hashtag

Last updated

Was this helpful?