netr0m / fluttersteem

[Pre-Alpha] Flutter/Dart Steem client library

fluttersteem

A Flutter/Dart Steem client library. This library includes support for authentication (SteemConnect V2) as well as Broadcasting (vote, comment, follow ++) and data retrieval (get followers, posts by users, users ++).

• Installation and Usage
• Authentication
  • Via Access Token
  • SteemApiAuth
  • Implicit Auth

Authentication

Via Access Token

If you already have an access token, you can authenticate a client.

Note: The user property of the SteemClient will be null.

var client = SteemApiAuth.authorizeViaAccessToken('<access-token>');
var me = await client.users.self.get();

SteemApiAuth

To perform authentication, use the SteemApiAuth class. All API scopes are included as SteemApiScope constants for convenience.

var auth = new SteemApiAuth('<client-id>', '<client-secret>',
  redirectUri: Uri.parse('<redirect-uri>'),
  scopes: [
    SteemApiScope.login,
    SteemApiScope.vote,
    // ...
  ]
);

Implicit Auth

Applications with no server-side component can implement implicit auth.

To get a redirect URI:

var redirectUri = auth.getImplicitRedirectUri();
window.location.href = redirectUri.toString();

After you have obtained an access token, use it to receive a SteemClient.

Endpoints

The SteemClient contains several getters that correspond to endpoints. Each is an abstraction over a specific Steem API.

Credits

This client library is written based on the code of instagram_dart

fluttersteem's Issues

URI parse error on Uri containing '?'

When a request Uri is parsed, and it contains a '?' question mark, it causes an exception:

// Report a parse failure.
  static void _fail(String uri, int index, String message) {    uri: "/lookup_accounts?lowerBoundName=amigos&limit=16"    index: 16    message: "Invalid character"
    throw new FormatException(message, uri, index);
  }

This happens to any Uri containing a '?', although '?' should be allowed (it's a reserved character of Uri's)

Credit/attribution notice

Hi, I noticed a great deal of similarity between this package and my earlier one: https://github.com/thosakwe/instagram_dart

This is fine. Such is the nature of open-source.

What I do ask, however, is that you put some sort of mention or reference to instagram_dart, so that if there are underlying bugs caught here, they can be fixed both in fluttersteem and instagram_dart. The MIT License simply asks that you reference the original when producing a copy.

Thanks.