Implement Ramper Telegram SDK
Guide
There are 2 ways to add Ramper Embedded Wallet to a Telegram Mini App:
Method 1: Using npm (Recommended)
npm link: https://www.npmjs.com/package/@ramper-v2/telegram-sdk
import RamperTelegram from 'ramper-telegram';
const sdkConfig = {
// gameId provided by Ramper, request before using the SDK
gameId: 'sdk_sample',
partner: 'coin98',
// partner app id provided by Ramper, request before using the SDK
appId: 'missing_app_id',
// callback functions for handling sign in success, sign in fail and sign message
onSignInSucess: (uProfile) => {
// handle user profile after sign in success
console.log('sign-in-success', uProfile);
},
onSignMessage: (msg) => {
// handle message after sign in success
console.log('sign-message-success', msg);
},
onSignInFail: (ev) => {
// handle sign in fail
console.error('sign-in-fail', ev);
}
}
// Initialize RamperTelegram
RamperTelegram.initializeAsync(sdkConfig)
.then(() => {
console.log('init ramper success')
})
.catch((reason => {
console.error('');
}))
Method 2: Using CDN in HTML
<!-- Double check the version of the SDK before using it -->
<script src="https://game-sdk.static.cyborg.game/rampertelegram.umd.production.min.js"></script>
<script>
RamperTelegram.initializeAsync({
// gameId provided by Ramper, request before using the SDK
gameId: 'sdk_sample',
partner: 'coin98',
// partner app id provided by Ramper, request before using the SDK
appId: 'missing_app_id',
// callback functions for handling sign in success, sign in fail and sign message
onSignInSucess: (uProfile) => {
// handle user profile after sign in success
console.log('sign-in-success', uProfile);
},
onSignMessage: (msg) => {
// handle message after sign in success
console.log('sign-message-success', msg);
},
onSignInFail: (ev) => {
// handle sign in fail
console.error('sign-in-fail', ev);
}
}).then(() => {
console.log('init ramper success')
}).catch((reason => {
console.error('');
}))
</script>
Functions
getSDKVersion
Description
The string representation of this SDK version.
getSDKVersion():
string
Returns
string
Returns string The SDK version.
Example
var sdkVersion = RamperTelegram.getSDKVersion(); // '1.0'
hideIframe
Description
Hide iframe
hideIframe():
void
Returns
void
Example
RamperTelegram.hideIframe();
initializeAsync
Description
Initializes the SDK library. This should be called before any other SDK functions. Login request be fired on this.
initializeAsync(
config
):Promise
<any
>
Parameters
• config: Object • Properties ts gameId: string; partner: string; onSignInSucess: (userProfile: UserProfile) => void; onSignMessage: (data: Object) => void; onSignInFail: (data: Object) => void;
Returns
Promise
<void
>
Example
RamperTelegram.initializeAsync({
gameId: 'sdk_sample',
partner: 'coin98',
appId: 'missing_app_id',
onSignInFail: (ev) => {
console.error('sign in fail');
},
onSignInSucess: (uProfile) => {
console.log('sign-in-success', uProfile);
},
onSignMessage: (msg) => {
console.log('sign-message-success', msg);
}
})
showIframe
Description
Open iframe with target url
showIframe(
url
,afterLoadUrlCallback
):void
Parameters
• url: string
set a callback to be fired on web loaded • afterLoadUrlCallback: any
Returns
void
Example
RamperTelegram.showIframe(
'example.com',
()=>{
console.log('load url success')
}
)
signMessage
Description
Sign a string data.
signMessage(
msg
):void
Parameters
• msg: string
Returns
void
Example
RamperTelegram.signMessage('Hello World');
signOut
Description
Sign out the user.
signOut(
callback
):void
Parameters
Set a callback to be fired when a logout is triggered. • callback: Function
RamperTelegram.signOut(function() {
console.log('logout event was triggered!');
})
Returns
void
Last updated