LATCH RUBY SDK
####Â PREREQUISITES ####
-
Ruby 1.9.3 or above.
-
Read API documentation (https://latch.telefonica.com/www/developers/doc_api).
-
To get the "Application ID" and "Secret", (fundamental values for integrating Latch in any application), it’s necessary to register a developer account in Latch's website: https://latch.telefonica.com. On the upper right side, click on "Developer area".
USING THE SDK IN RUBY
- Require "Latch". Keep in mind where the SDK is placed inside your folder structure.
require_relative '/latch/Latch'
- Create a Latch object with the "Application ID" and "Secret" previously obtained.
api = Latch.new(appid, app_secret)
- Call to Latch Server. Pairing will return an account id that you should store for future api calls
pairResponse = api.pair(PAIRING_CODE_HERE)
statusResponse = api.status(ACCOUNT_ID_HERE)
unpairResponse = api.unpair(ACCOUNT_ID_HERE)
- After every API call, get Latch response data and errors and handle them.
responseData = response.data
responseError = response.error
USING RUBY SDK FOR WEB3 SERVICES
For using the Ruby SDK within an Web3 service, you must complain with the following:
- It is necessary to have a developer subscription that allows you to create web3 apps.
- You need metamask extension for Google Chrome Download metamask
- You need a wallet to operate on Polygon. You can easily create one through Metamask.
Creation of a WEB3 Latch app
Once you have your developer Latch account created, you must logging in the website.
Steps to add new web3 app in latch-website
We add a new method to pair the web3 applications, now we have two new parameters. The two additional parameters are:
- WEB3WALLET: The Ethereum-based address wallet for the user that wants to pair the service.
- WEB3SIGNATURE: A proof-of-ownership signature of a constant, in order to verify that the user owns the private key of the wallet. You can use https://etherscan.io/verifiedSignatures# to sign the following message:
- MESSAGE TO SIGN : "Latch-Web3"
- Call to Latch Server for pairing as usual, but with the newly methods:
api = latch.Latch(APP_ID, SECRET_KEY)
# PAIR
response = api.pair(pairing_code, WEB3WALLET, WEB3SIGNATURE)
You have an example of use in the file example for web3 app