Skip to content

Commit

Permalink
chore: update rn sdk docs
Browse files Browse the repository at this point in the history
  • Loading branch information
kalashshah committed Nov 14, 2023
1 parent 01a8595 commit c63b3b2
Showing 1 changed file with 333 additions and 4 deletions.
337 changes: 333 additions & 4 deletions packages/reactnative/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,337 @@
# @push/react-native-sdk
PUSH
<h1 align="center">
<a href="https://push.org/#gh-light-mode-only">
<img width='20%' height='10%'
src="https://res.cloudinary.com/drdjegqln/image/upload/v1686227557/Push-Logo-Standard-Dark_xap7z5.png">
</a>
<a href="https://push.org/#gh-dark-mode-only">
<img width='20%' height='10%'
src="https://res.cloudinary.com/drdjegqln/image/upload/v1686227558/Push-Logo-Standard-White_dlvapc.png">
</a>
</h1>

## Installation
<p align="center">
<i align="center">Push Protocol is a web3 communication network, enabling cross-chain notifications, messaging, video, and NFT chat for dapps, wallets, and services.🚀</i>
</p>

```sh
<h4 align="center">

<a href="https://discord.com/invite/pushprotocol">
<img src="https://img.shields.io/badge/discord-7289da.svg?style=flat-square" alt="discord">
</a>
<a href="https://twitter.com/pushprotocol">
<img src="https://img.shields.io/badge/twitter-18a1d6.svg?style=flat-square" alt="twitter">
</a>
<a href="https://www.youtube.com/@pushprotocol">
<img src="https://img.shields.io/badge/youtube-d95652.svg?style=flat-square&" alt="youtube">
</a>
</h4>
</h1>

# Index

- [Push React Native SDK](#push-react-native-sdk)
- [How to use in your app?](#how-to-use-in-your-app)

- [Install the SDK](#install-the-sdk)
- [Install the peer dependencies](#install-the-peer-dependencies)
- [Nodeify the crypto packages](#nodeify-the-crypto-packages)
- [Wrap your app with the PushRNWrapper](#wrap-your-app-with-the-pushrnwrapper)
- [Start using the Push SDK in your app](#start-using-the-push-sdk-in-your-app)

- [React Native SDK Features](#react-native-sdk-features)

- [User](#user)
- [Create User](#create-user)
- [Get User](#get-user)
- [Profile Update](#profile-update)
- [Profile Upgrade](#profile-upgrade)
- [Chat](#chat)
- [Decrypt PGP key](#decrypt-pgp-key)
- [Chats](#chats)
- [Conversation Hash](#conversation-hash)
- [Latest Chat message](#latest-chat-message)
- [Create Group](#create-group)
- [Update Group](#update-group)

- [Other Features](#other-features)
- [Resources](#resources)
- [Contributing](#contributing)
- [License](#license)

# Push React Native SDK

<p>
Push SDK provides an abstraction layer to integrate Push protocol features with your Frontend as well as Backend.
This SDK is a react-native based repo of packages that helps developers to :

- Build PUSH features into their DApps
- Notifications
- Chat
- Group Chat

without having to write a lot of boilerplate code. All the heavy lifting is done by the SDK, so that you the developer can focus on building features and bootstrap a DApp with PUSH features in no time!

</p>
</div>

## How to use in your app?

#### Install the SDK

```bash
yarn add @push/react-native-sdk
```

or

```bash
npm install @push/react-native-sdk
```

#### Install the peer dependencies

```bash
yarn add [email protected] [email protected] [email protected]
```

or

```bash
npm install [email protected] [email protected] [email protected]
```

#### Nodeify the crypto packages

Add postinstall script in your `package.json` file if `node_modules` are not nodeified already

```bash
"postinstall": "node_modules/.bin/rn-nodeify --install crypto,assert,url,stream,events,http,https,os,url,net,fs --hack"
```

#### Wrap your app with the PushRNWrapper

```jsx
import { PushRNWrapper } from '@push/react-native-sdk';

return (
<PushRNWrapper>
<App />
</PushRNWrapper>
);
```

#### Start using the Push SDK in your app

```jsx
import { createUser, Constants } from '@push/react-native-sdk';

const user = await createUser({
account: account,
signer: signer,
env: Constants.ENV.DEV,
});
```

## React Native SDK Features

### User

#### Create User

```jsx
import { createUser, Constants } from '@push/react-native-sdk';

const user = await createUser({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
signer: signer,
env: Constants.ENV.DEV,
});
```

#### Get User

```jsx
import { get, Constants } from '@push/react-native-sdk';

const user = await get({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
env: Constants.ENV.DEV,
});
```

#### Profile Update

```jsx
import { profileUpdate, Constants } from '@push/react-native-sdk';

await profileUpdate({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
env: Constants.ENV.DEV,
pgpPrivateKey: pgpPrivateKey,
profile: {
name: 'Updated Name',
desc: 'Updated Desc',
},
});
```

#### Profile Upgrade

```jsx
import { profileUpgrade, Constants } from '@push/react-native-sdk';

const upgradedProfile = await profileUpgrade({
signer: signer,
pgpPrivateKey: pgpPrivateKey,
pgpPublicKey: pgpPublicKey,
pgpEncryptionVersion: Constants.ENCRYPTION_TYPE.NFTPGP_V1,
account: account,
env: Constants.ENV.DEV,
additionalMeta: {
NFTPGP_V1: {
password: '0xrandompass', //new nft profile password
},
},
});
```

### Chat

#### Decrypt PGP key

```jsx
import { PushApi } from '@push/react-native-sdk';

const user = await get({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
env: Constants.ENV.DEV,
});

const pgpDecryptedPvtKey = await PushApi.chat.decryptPGPKey({
encryptedPGPPrivateKey: user.encryptedPrivateKey,
signer: signer,
});
```

#### Chats

```jsx
import { chats, Constants } from '@push/react-native-sdk';

const chatList = await chats({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
pgpPrivateKey: pgpDecryptedPvtKey,
toDecrypt: true,
env: Constants.ENV.DEV,
});
```

#### Conversation Hash

```jsx
import { PushApi, Constants } from '@push/react-native-sdk';

const hash = await PushApi.chat.conversationHash({
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
conversationId: conversationId,
env: Constants.ENV.DEV,
});
```

#### Latest Chat message

```jsx
import { latest, Constants } from '@push/react-native-sdk';

const msg = await latest({
threadhash: hash,
toDecrypt: true,
account: 'eip155:0xACEe0D180d0118FD4F3027Ab801cc862520570d1',
env: Constants.ENV.DEV,
});
```

#### Create Group

```jsx
import { createGroup, Constants } from '@push/react-native-sdk';

const res = await createGroup({
groupName: groupName,
groupDescription: 'test',
groupImage: 'https://github.com',
account: account,
signer: signer,
members: [
'0x83d4c16b15F7BBA501Ca1057364a1F502d1c34D5',
'0x6Ff7DF70cAACAd6B35d2d30eca6bbb4E86fEE62f',
],
admins: [],
isPublic: true,
env: Constants.ENV.DEV,
});
```

#### Update Group

```jsx
import { updateGroup, Constants } from '@push/react-native-sdk';

const res = await updateGroup({
groupName,
groupDescription: 'test',
groupImage: 'https://github.com',
chatId,
account: account,
signer: signer,
admins: ['0x83d4c16b15F7BBA501Ca1057364a1F502d1c34D5'],
members: [
'0x6Ff7DF70cAACAd6B35d2d30eca6bbb4E86fEE62f',
'0x6d118b28ebd82635A30b142D11B9eEEa2c0bea26',
'0x83d4c16b15F7BBA501Ca1057364a1F502d1c34D5',
],
env: Constants.ENV.DEV,
});
```

## Other Features

All the remaining features of the `restapi` SDK are available in a similar manner to the `restapi` package. You can read more about them <a href="https://github.com/ethereum-push-notification-service/push-sdk/blob/main/packages/restapi/README.md">HERE</a>

These functions can be accessed by simply importing the `PushApi` object from the `@push/react-native-sdk` package.

```jsx
import { PushApi } from '@push/react-native-sdk';

const response = await PushApi.chat.getGroupByName({
groupName: 'Push Group Chat 3',
env: 'staging',
});
```

## Resources

- **[Website](https://push.org)** To checkout our Product.
- **[Docs](https://docs.push.org/developers/)** For comprehensive documentation.
- **[Blog](https://medium.com/push-protocol)** To learn more about our partners, new launches, etc.
- **[Discord](discord.gg/pushprotocol)** for support and discussions with the community and the team.
- **[GitHub](https://github.com/ethereum-push-notification-service)** for source code, project board, issues, and pull requests.
- **[Twitter](https://twitter.com/pushprotocol)** for the latest updates on the product and published blogs.

## Contributing

Push Protocol is an open source Project. We firmly believe in a completely transparent development process and value any contributions. We would love to have you as a member of the community, whether you are assisting us in bug fixes, suggesting new features, enhancing our documentation, or simply spreading the word.

- Bug Report: Please create a bug report if you encounter any errors or problems while utilising the Push Protocol.
- Feature Request: Please submit a feature request if you have an idea or discover a capability that would make development simpler and more reliable.
- Documentation Request: If you're reading the Push documentation and believe that we're missing something, please create a docs request.

Read how you can contribute <a href="https://github.com/ethereum-push-notification-service/push-sdk/blob/main/contributing.md">HERE</a>

Not sure where to start? Join our discord and we will help you get started!

<a href="https://discord.gg/pushprotocol" title="Join Our Community"><img src="https://www.freepnglogos.com/uploads/discord-logo-png/playerunknown-battlegrounds-bgparty-15.png" width="200" alt="Discord" /></a>

## License

Check out our License <a href='https://github.com/ethereum-push-notification-service/push-sdk/blob/main/license-v1.md'>HERE </a>

0 comments on commit c63b3b2

Please sign in to comment.